Saltar al contenido principal
Esta guía crea un contacto, inicia una conversación con un usuario interno de Bridge y crea un mensaje. Ejecútala en tu servidor.
Usa un contacto de prueba al que tengas autorización para escribir. Crear una conversación puede ejecutar las plantillas de inicio del espacio de trabajo antes de la solicitud independiente que crea el mensaje. Revisa primero esa configuración: establecer en false el indicador de envío externo del mensaje posterior no desactiva las plantillas de inicio de la conversación.

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 providerChannelId de 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 enableExternalBroadcast explícitamente: true solicita el envío externo cuando lo permiten las reglas de la conversación y del destinatario; false crea 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 con fetch 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 201 al crear el contacto proporciona su identidad y espacio de trabajo. Lee type para conocer su clasificación real: NORMAL o PARTIAL.
  • Una respuesta 201 de 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 el name ni el status solicitados.
  • Una respuesta 201 de mensaje proporciona messageId. Por sí sola, no demuestra que WhatsApp haya entregado el mensaje al contacto.
Esta guía asigna explícitamente un usuario interno de Bridge. Para asignar mediante un equipo, usa la opción documentada 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