Antes de comenzar
- Obtén una clave de API para usar desde el servidor en Autenticación.
- Consigue el ID del espacio de trabajo, el
providerChannelIdde una línea activa de WhatsApp y el correo de un usuario interno de Bridge. Consulta Identificadores y conceptos. - Usa un número nuevo de prueba en formato internacional. Si el contacto ya existe, usa la consulta de contactos por identificador en lugar de crearlo otra vez.
- Revisa los atributos personalizados obligatorios y la secuencia de plantillas de inicio del espacio de trabajo. Este ejemplo mínimo no proporciona atributos personalizados ni reemplaza las plantillas.
- Elige
enableExternalBroadcastexplícitamente:truesolicita el envío externo cuando lo permiten las reglas de la conversación y del destinatario;falsecrea el mensaje, pero omite ese envío externo. Ningún valor confirma la entrega por parte del proveedor. Este indicador no anula reglas de visibilidad ni permisos.
La secuencia
El
id del contacto se convierte en el identifier del participante externo, con identifierType: "ID". El id de la conversación se convierte en el conversationId del mensaje.
Ejecuta el ejemplo
Usa Node.js confetch integrado. Guarda el ejemplo como first-conversation.mjs. Proporciona estas variables de entorno mediante la configuración y el sistema de secretos de tu servidor:
Los nombres y el mensaje que aparecen abajo son ejemplos. Reemplázalos con el contenido previsto para tu prueba antes de ejecutarla.
Entiende el resultado
- Una respuesta
201al crear el contacto proporciona su identidad y espacio de trabajo. Leetypepara conocer su clasificación real:NORMALoPARTIAL. - Una respuesta
201de conversación proporciona el ID que debes usar en el siguiente paso. Cuando no hay líneas libres, Bridge puede recuperar una conversación liberada que tenga exactamente los participantes solicitados. Se conservan su ID e historial; en ese caso de recuperación no se aplican elnameni elstatussolicitados. - Una respuesta
201de mensaje proporcionamessageId. Por sí sola, no demuestra que WhatsApp haya entregado el mensaje al contacto.
teamId en lugar de participants.internals: son mutuamente excluyentes.
Si falla un paso
El ejemplo se detiene en la solicitud que falla y nunca reintenta automáticamente una escritura. Un fallo de red puede dejar el resultado incierto. Comprueba el recurso correspondiente antes de repetir una operación de creación o envío.
Consulta Respuestas y errores para conocer los formatos de respuesta y las decisiones de recuperación.
Próximos pasos
- Carga y envía un adjunto.
- Elige y completa una plantilla de WhatsApp.
- Consulta los contratos completos de solicitud y respuesta de crear un contacto, crear una conversación y crear un mensaje.

