.webp)
Para enviar mensajes de plantilla de WhatsApp desde las plantillas de incidentes de Everbridge, se necesita algo más que una vista previa. La integración con ChatArchitect utiliza una variable de incidente específica llamada Código de WhatsApp para identificar la plantilla de WhatsApp aprobada y, a continuación, crea sus parámetros a partir de los valores introducidos en el Formulario del operador. Los nombres de los campos, los números de secuencia y el orden de los parámetros determinan cómo se ensambla el mensaje.
Esta guía explica cómo configurar ese flujo de trabajo mediante una alerta de incidentes práctica de tres parámetros. También aborda los errores que pueden alterar el mensaje final: valores faltantes, variables de incidente adicionales, un campo de ID mal ubicado y confusión entre el ID de la plantilla de Everbridge y el ID de la plantilla de WhatsApp.
Cómo Everbridge envía una plantilla de WhatsApp a través de ChatArchitect
La plantilla de WhatsApp aprobada proporciona el texto fijo. Everbridge proporciona los valores específicos del incidente, como la ubicación, la descripción del evento y la hora. ChatArchitect combina el ID de la plantilla de WhatsApp con esos valores para preparar el envío de la plantilla.
Por ejemplo, la plantilla aprobada podría decir: «Incidente en {{1}}: {{2}}. Reportado en {{3}}». Un operador introduce el sitio, el evento y la hora en variables de incidente separadas. Con la configuración correcta, esos valores rellenan los tres marcadores de posición en orden.
Este artículo se centra en el comportamiento de creación de mensajes introducido entre el 31 de mayo y el 3 de junio de 2025 para una integración existente de Everbridge y ChatArchitect. Se trata de una guía de configuración, no de un reemplazo para la configuración inicial de la integración. Para una introducción más completa, consulte nuestra descripción general de la integración de la API de WhatsApp Business con Everbridge.
Lo que necesitas antes de configurar la plantilla de incidentes
Prepare lo siguiente antes de editar el formulario:
- Una integración existente de Everbridge conectada a ChatArchitect.
- Acceso a la organización correspondiente en el Portal de Everbridge Manager y permiso para editar sus variables y plantillas de incidentes.
- Plantilla de mensaje de WhatsApp aprobada disponible en ChatArchitect.
- El ID exacto de la plantilla de WhatsApp, copiado con sus llaves.
- Una lista de los marcadores de posición de la plantilla y el valor que debe recibir cada uno.
- El perfil de suscripción de respuesta configurado para su integración.
- Destinatarios designados para la primera prueba de envío controlado.
Anote el orden de los marcadores de posición antes de trabajar en Everbridge. Si {{1}} representa el sitio y {{2}} representa el evento, el formulario debe pasar el valor del sitio antes que el del evento. Los nombres claros de las variables ayudan al operador, pero los nombres por sí solos no establecen la asignación de parámetros.
Paso 1: Copie el ID de plantilla de WhatsApp correcto
Abre la aplicación ChatArchitect, elige la plantilla de WhatsApp aprobada que necesites y copia su ID. Mantén el valor copiado intacto, incluyendo las llaves. Deberás pegar este valor en la variable de incidente llamada Código de WhatsApp.
No sustituya el ID de plantilla que aparece en el encabezado de la plantilla de incidentes de Everbridge. Este identifica la plantilla de Everbridge. El código de WhatsApp necesita el identificador de la plantilla de mensaje de WhatsApp seleccionada en ChatArchitect.
Mantén separadas las funciones de ambos contenidos: el ID selecciona la plantilla de WhatsApp aprobada; las variables del incidente proporcionan sus valores de parámetros. Editar el texto del mensaje saliente de Everbridge no es lo mismo que seleccionar una plantilla de WhatsApp diferente.
Paso 2: Crear las variables del incidente
En el portal de Everbridge Manager, seleccione la organización correspondiente y abra Comunicaciones → Incidentes → Variables. Haga clic en Nueva variable, seleccione Cuadro de textoy asigne a la variable de ID el nombre exacto Código de WhatsApp. Elija un límite de caracteres adecuado para el identificador copiado y, a continuación, haga clic en Aceptar.
Crea o reutiliza una variable para cada parámetro de la plantilla de WhatsApp. En el ejemplo de esta guía, usa Sitio, Eventoy Hora. Cada una debe proporcionar un valor de texto sin formato. Introduce el nombre de un edificio como Edificio A, por ejemplo, en lugar de añadir manualmente corchetes a su alrededor.
La integración lee el primer valor de cada variable de incidente. Una variable de selección múltiple no genera automáticamente un parámetro de WhatsApp para cada opción seleccionada. Los campos de valor único facilitan la revisión del mapeo y evitan esa ambigüedad.
Paso 3: Agregar y ordenar campos en el formulario del operador
Abre Comunicaciones → Incidentes → Plantillas y edita la plantilla de incidente correspondiente. En Formulario y mensaje, incluye el código de WhatsApp y todas las variables necesarias para la plantilla de WhatsApp seleccionada. Marca los campos obligatorios; si un valor vacío impide que el mensaje se muestre correctamente.
A continuación, abra VISTA PREVIA Y EDITAR → Formulario del operador. Revise los números que aparecen junto a las variables y organice los campos arrastrándolos a la posición deseada.
El código de WhatsApp y todos los parámetros de WhatsApp deben tener un número de secuencia de 3 o superior. Los campos con un número inferior a este umbral se ignoran en este flujo de trabajo. Coloque el campo ID en tercer lugar o posterior, y luego coloque los campos de parámetros en el orden esperado por la plantilla aprobada.
El orden del formulario que se muestra es una guía útil, pero esta configuración presupone que coincide con los números de secuencia enviados por su implementación. Si un campo aparece correctamente ubicado pero no aparece en el resultado de WhatsApp, solicite al administrador de la integración que verifique los números de secuencia reales.
El comportamiento revisado también incluye los campos de parámetros elegibles ubicados antes del código de WhatsApp. Mantener el ID delante de los parámetros facilita la inspección del formulario, pero moverlo no elimina los demás campos elegibles de la lista de parámetros.
Un ejemplo completo de alerta de incidentes con tres parámetros
Supongamos que la plantilla de mensaje de WhatsApp aprobada contiene este texto:
Incidente en {{1}}: {{2}}. Reportado en {{3}}.
Configure la sección de WhatsApp del formulario del operador en este orden:
- Posición 3 — Código de WhatsApp: {{your-template-id}}
- Posición 4 — Sitio: Edificio A
- Posición 5 — Evento: Apagón
- Posición 6 — Tiempo: 14:30
El valor {{your-template-id}} es solo un ejemplo, no un ID para copiar. Reemplácelo con el identificador exacto copiado de su plantilla aprobada en ChatArchitect.
La integración genera la siguiente cadena de envío:
{{your-template-id}} {{Edificio A}} {{Apagón}} {{14:30}}
El mensaje que se recibió en WhatsApp es:
Incidente en el Edificio A: Corte de luz. Se reportó a las 14:30.
El operador introduce «Edificio A», «Apagón»y «14:30» como texto plano. La integración añade los corchetes de los parámetros durante el ensamblaje del mensaje. Conserva los corchetes en el ID de plantilla copiado, pero no los añadas manualmente a los valores de los parámetros habituales.
Paso 4: Compruebe la configuración de mensajes salientes y de entrega
En Mensaje saliente → Todos los métodos de entrega, conserve el contenido de la plantilla copiado de ChatArchitect, siguiendo las instrucciones de configuración de la integración. A continuación, revise la configuración, seleccione WhatsApp como método de entrega y elija el perfil de suscripción de respuesta. Guarde la plantilla.
Cuando se completa un campo de código de WhatsApp válido, la plantilla de WhatsApp que se envía utiliza ese ID y los valores del formulario. Modificar únicamente el texto del mensaje saliente no altera la plantilla de WhatsApp seleccionada ni sus parámetros. Para modificarlos, actualice el código de WhatsApp o las variables de incidente correspondientes.
Mantenga esta distinción en las instrucciones para el operador. De lo contrario, alguien podría editar la vista previa del mensaje saliente y asumir que el destinatario de WhatsApp recibirá el texto revisado, aunque la plantilla aprobada y los parámetros proporcionados sigan siendo los mismos.
Paso 5: Inicie una prueba controlada e inspeccione WhatsApp
Abra Comunicaciones → Incidentes → Iniciar incidente, seleccione la plantilla configurada y complete el Formulario del operador. Verifique el ID de la plantilla, cada parámetro y los destinatarios antes de continuar.
Continúe hasta el siguiente paso, revise los detalles del incidente y las opciones de envío, y utilice la función Revisar y enviar. El botón Revisar depende de la configuración de revisión de la organización, por lo que el flujo de revisión exacto puede variar.
Para el primer envío tras un cambio de plantilla, seleccione destinatarios de prueba específicos. Compare el mensaje de WhatsApp real con el resultado esperado: compruebe la redacción, el orden de los parámetros, la ortografía y que esté completo.
La vista previa de Everbridge muestra el mensaje saliente configurado en Everbridge. No reemplaza la verificación del mensaje de plantilla de WhatsApp recibido. Considere una prueba de extremo a extremo exitosa como un paso de verificación independiente antes de usar el formulario revisado para notificaciones operativas.
Cuatro reglas que evitan la asignación incorrecta de parámetros
1. El orden de los campos determina los valores de los marcadores de posición
La integración envía los valores válidos en el orden original de los campos. Cambiar el nombre de una variable no modifica su valor. Si el mensaje recibido intercambia el sitio y el evento, verifique primero la secuencia del formulario.
2. Los campos adicionales completados pueden convertirse en parámetros
También se incluyen otras variables de incidente con números de secuencia de 3 o superiores cuando se completan. Revise todo el formulario, incluidos los campos no relacionados con WhatsApp. Un valor adicional antes de los parámetros previstos puede cambiar el recuento de parámetros o modificar la asignación.
3. Los valores vacíos se omiten
Un campo en blanco no reserva una posición vacía. Los valores que se introduzcan posteriormente pueden desplazarse. En el ejemplo anterior, dejar el campo Sitio en blanco podría provocar que el campo Apagón ocupe la primera posición del parámetro. Es necesario completar todos los valores que requiera la plantilla seleccionada.
4. El código de WhatsApp controla el flujo de trabajo de la plantilla
Si el código de WhatsApp no está presente, está vacío o tiene un número de secuencia inferior a 3, la integración recurre al texto del mensaje saliente de Everbridge y no agrega las demás variables del incidente. Esto describe el ensamblaje del mensaje; no garantiza que se envíe un mensaje alternativo a través de WhatsApp. Para este flujo de trabajo de plantilla, proporcione siempre el ID válido correcto.
Solución de problemas con los mensajes de plantilla de WhatsApp de Everbridge
Aparece información incorrecta en un marcador de posición. Compare el orden de los parámetros con la plantilla aprobada. Verifique que no haya valores en blanco ni campos adicionales que cumplan los requisitos antes de modificar la redacción de la plantilla.
Falta un campo en el mensaje. Confirme que tiene un valor, aparece en el formulario del operador y tiene un número de secuencia real de al menos 3. Si se trata de una variable de selección múltiple, recuerde que solo se lee su primer valor.
La integración utiliza el texto saliente en lugar de la cadena de plantilla prevista. Verifique el nombre exacto de la variable Código de WhatsApp, su ID copiado y su número de secuencia. No utilice el ID de encabezado de la plantilla de incidentes de Everbridge.
La vista previa de Everbridge parece correcta, pero la de WhatsApp es diferente. Inspeccione el código de WhatsApp y los valores del formulario. Un ID válido seleccionado elige la plantilla de WhatsApp independientemente de las modificaciones realizadas al texto saliente.
El mensaje de WhatsApp esperado no llega. Verifique el método de entrega seleccionado, el perfil de integración, los destinatarios y la plantilla aprobada, además de la configuración del formulario. El ensamblaje correcto de parámetros por sí solo no garantiza la ruta de entrega completa.
Preguntas frecuentes
¿Cuál es el código de WhatsApp en Everbridge?
Es la variable de incidente que utiliza la integración de ChatArchitect para contener el ID de la plantilla de mensaje de WhatsApp. Su nombre debe ser exactamente el código de WhatsApp y su número de secuencia debe ser 3 o superior.
¿Debo encerrar los valores de los incidentes entre llaves?
No. Introduzca los valores de los parámetros como texto sin formato. La integración añadirá los corchetes. El ID de la plantilla es diferente: conserve los corchetes tal como los copió de ChatArchitect.
¿Pueden los campos de parámetros ir antes del código de WhatsApp?
Sí. El comportamiento revisado incluye campos de parámetros válidos no vacíos, incluso cuando preceden al ID. Sus números de secuencia deben seguir siendo 3 o superior, y su orden debe coincidir con los marcadores de posición de la plantilla.
¿Cambiar el mensaje saliente selecciona una plantilla diferente?
No, cuando se haya introducido un código de WhatsApp válido. Cambia ese ID para seleccionar otra plantilla aprobada y, a continuación, revisa la cantidad y el orden de sus parámetros.
¿Qué debo actualizar en una plantilla de incidentes antigua?
Agregue o complete el código de WhatsApp, incluya todas las variables de parámetros requeridas y verifique sus números de secuencia y orden. La integración revisada conserva una opción de respaldo en texto plano. ChatArchitect anunció por separado que, a partir del 1 de agosto de 2025, se requerirá un ID para el envío de plantillas; copie siempre el ID correcto para el flujo de trabajo de plantillas descrito aquí.
Prepara tu flujo de trabajo de WhatsApp para Everbridge con ChatArchitect
Una configuración de formulario fiable comienza con un ID de plantilla preciso y una secuencia de parámetros predecible. La tarea del operador debe ser clara: seleccionar la plantilla deseada, completar todos los campos obligatorios, revisar los destinatarios y verificar el mensaje recibido tras los cambios de configuración.
Utilice la guía de configuración de plantillas de ChatArchitect Everbridge como referencia. Si está planificando su integración, revise los planes de la API de ChatArchitect para WhatsApp Business y prepare un mensaje de incidente de ejemplo con los campos que su equipo necesita.
