.webp)
Para enviar mensagens de modelo do WhatsApp a partir dos Modelos de Incidentes do Everbridge, precisa de mais do que uma pré-visualização da mensagem. A integração com o ChatArchitect utiliza uma variável de incidente dedicada, denominada Código WhatsApp , para identificar o modelo WhatsApp aprovado e, em seguida, constrói os seus parâmetros a partir dos valores introduzidos no Formulário do Operador. Os nomes dos campos, os números de sequência e a ordem dos parâmetros determinam a forma como a mensagem é montada.
Este guia explica como configurar este fluxo de trabalho, utilizando um alerta de incidente prático com três parâmetros. Aborda também os erros que podem alterar a mensagem final: valores em falta, variáveis de incidente extra, um campo de ID mal posicionado e confusão entre o ID do modelo Everbridge e o ID do modelo WhatsApp.
Como o Everbridge envia um modelo WhatsApp através do ChatArchitect
O modelo aprovado do WhatsApp fornece o texto fixo. O Everbridge fornece os valores específicos do incidente, como o local, a descrição do evento e o horário. O ChatArchitect combina o ID do modelo do WhatsApp com estes valores para preparar o envio do modelo.
Por exemplo, o modelo aprovado poderia dizer “Incidente em {{1}}: {{2}}. Reportado em {{3}}.” Um operador introduz o local, o evento e a hora em variáveis de incidente separadas. Com a configuração correta, estes valores preenchem os três espaços reservados pela ordem correta.
Este artigo aborda o comportamento de criação de mensagens introduzido entre 31 de maio e 3 de junho de 2025 para uma integração existente entre o Everbridge e o ChatArchitect. Trata-se de um guia de configuração, e não de um substituto para a configuração inicial da integração. Para uma introdução mais abrangente, leia a nossa visão geral da integração da API do WhatsApp Business com o Everbridge.
O que precisa antes de configurar o Modelo de Incidente
Prepare o seguinte antes de editar o formulário:
- Uma integração existente do Everbridge ligada ao ChatArchitect.
- Acesso à organização relevante no Portal do Gestor da Everbridge e permissão para editar as suas variáveis e modelos de incidentes.
- Um modelo de mensagem WhatsApp aprovado, disponível no ChatArchitect.
- O ID exato do modelo do WhatsApp, copiado com as suas chaves.
- Uma lista dos espaços reservados do modelo e o valor que cada um deve receber.
- O perfil de assinatura de resposta configurado para a sua integração.
- Destinatários de teste designados para o primeiro envio controlado.
Anote a ordem dos marcadores de posição antes de trabalhar no Everbridge. Se {{1}} representa o site e {{2}} representa o evento, o formulário tem de passar o valor do site antes do valor do evento. Os nomes das variáveis claros ajudam o operador, mas os nomes por si só não estabelecem o mapeamento dos parâmetros.
Passo 1: Copie o ID do modelo do WhatsApp correto
Abra a aplicação ChatArchitect, escolha o modelo de WhatsApp aprovado pretendido e copie o ID. Mantenha o valor copiado intacto, incluindo as chaves. Irá colar esse valor na variável de incidente chamada Código WhatsApp.
Não substitua o ID do modelo apresentado no cabeçalho do modelo de incidente Everbridge. Este ID identifica o modelo do Everbridge. O código WhatsApp necessita do identificador do modelo de mensagem WhatsApp selecionado no ChatArchitect.
Mantenha as funções dos dois conteúdos separadas: o ID seleciona o modelo aprovado do WhatsApp; as variáveis incidente fornecem os valores dos parâmetros. Editar o texto na mensagem enviada pelo Everbridge não é o mesmo que selecionar um modelo diferente do WhatsApp.
Passo 2: Criar as variáveis do incidente
No Portal do Gestor do Everbridge, selecione a organização adequada e abra Comunicações → Incidentes → Variáveis. Clique em Nova Variável, selecione Caixa de Textoe nomeie a variável ID exatamente como Código WhatsApp. Escolha um limite de caracteres adequado para o identificador copiado e clique em OK.
Crie ou reutilize uma variável para cada parâmetro do modelo WhatsApp. Para o exemplo neste guia, utilize `Site`, `Event`e `Time`. Cada uma deve fornecer um valor de texto simples. Introduza o nome de um edifício como `Building A`, por exemplo, em vez de adicionar manualmente parênteses rectos de parâmetros à sua volta.
A integração lê o primeiro valor de cada variável incidente. Uma variável de seleção múltipla não gera automaticamente um parâmetro WhatsApp para cada opção selecionada. Os campos de valor único facilitam a revisão do mapeamento e evitam esta ambiguidade.
Passo 3: Adicione e ordene os campos no formulário do operador
Aceda a Comunicações → Incidentes → Modelos e edite o Modelo de Incidente relevante. Em Formulário e Mensagem, inclua o Código WhatsApp e todas as variáveis necessárias para o modelo WhatsApp selecionado. Marque os campos obrigatórios onde um valor vazio impediria o envio da mensagem correta.
Em seguida, abra VISUALIZAR E EDITAR → Formulário do Operador. Analise os números apresentados ao lado das variáveis e organize os campos arrastando-os para a posição pretendida.
O código do WhatsApp e todos os parâmetros do WhatsApp devem ter um número de sequência igual ou superior a 3. Os campos abaixo deste limite são ignorados para este fluxo de trabalho do modelo. Coloque o campo ID em terceiro lugar ou depois, e em seguida, coloque os campos de parâmetro na ordem esperada pelo modelo aprovado.
A ordem do formulário apresentada é um guia útil, mas esta configuração pressupõe que corresponde aos números de sequência enviados pela sua implementação. Se um campo aparecer posicionado corretamente, mas estiver ausente do resultado do WhatsApp, peça ao administrador da integração para verificar os números de sequência reais.
O comportamento revisto também inclui campos de parâmetros elegíveis colocados antes do código WhatsApp. Manter o ID antes dos parâmetros facilita a inspeção do formulário, mas movê-lo não remove outros campos elegíveis da lista de parâmetros.
Um exemplo completo de um alerta de incidente com três parâmetros
Suponha que o modelo de mensagem aprovado do WhatsApp contém o seguinte texto:
Incidente em {{1}}: {{2}}. Reportado em {{3}}.
Configure a secção WhatsApp no Formulário do Operador por esta ordem:
- Posição 3 — Código WhatsApp: {{your-template-id}}
- Posição 4 — Local: Edifício A
- Posição 5 — Evento: Falha de energia
- Posição 6 — Tempo: 14:30
O valor {{your-template-id}} é uma ilustração, não um ID para copiar. Substitua-o pelo identificador exato copiado do seu modelo aprovado no ChatArchitect.
A integração cria a seguinte string de envio:
{{your-template-id}} {{Edifício A}} {{Falha de energia}} {{14:30}}
A mensagem pretendida recebida no WhatsApp é:
Incidente no Edifício A: Falha de energia. Reportado às 14h30.
O operador introduz "Edifício A", "Falha de energia"e "14:30" em texto simples. A integração adiciona os parêntesis rectos dos parâmetros durante a montagem da mensagem. Preservar os parêntesis rectos no ID do modelo copiado, mas não os adicione manualmente aos valores dos parâmetros comuns.
Passo 4: Verifique as definições de mensagem de saída e de entrega
Em Mensagens de saída → Todos os métodos de entrega , mantenha o conteúdo do modelo copiado do ChatArchitect, seguindo as instruções de configuração da integração. Em seguida, reveja as Definições do Modelo de Incidente , selecione WhatsApp como método de entrega e escolha o Perfil de Assinatura de Resposta adequado . Guarde o modelo.
Quando um campo de código WhatsApp válido é preenchido, o modelo de envio do WhatsApp utiliza esse ID e os valores do formulário. Alterar apenas o texto da mensagem de saída não altera o modelo de WhatsApp selecionado nem os seus parâmetros. Para os alterar, atualize o código WhatsApp ou as variáveis de incidente relevantes.
Mantenha esta distinção nas instruções para o operador. Caso contrário, alguém poderia editar a pré-visualização da mensagem enviada e assumir que o destinatário do WhatsApp receberá a mensagem revista, mesmo que o modelo aprovado e os parâmetros fornecidos permaneçam os mesmos.
Passo 5: Inicie um teste controlado e inspecione o WhatsApp
Aceda a Comunicações → Incidentes → Iniciar Incidente, escolha o modelo configurado e preencha o Formulário de Operador. Verifique o ID do modelo, cada parâmetro e os destinatários antes de prosseguir.
Prossiga para o passo seguinte, reveja os detalhes do incidente e as opções de envio e utilize "Revisar e Enviar". O botão "Revisar" depende das definições de revisão da organização, pelo que o fluxo de revisão exato pode variar.
Para o primeiro envio após uma alteração no modelo, selecione os destinatários de teste designados. Compare a mensagem WhatsApp recebida com o resultado esperado: verifique a redação correta, a ordem dos parâmetros, a ortografia e se a mensagem está completa.
A pré-visualização do Everbridge mostra a mensagem de saída configurada no Everbridge. Não substitui a verificação da mensagem modelo recebida do WhatsApp. Considere um teste de ponta a ponta bem-sucedido como um passo de verificação separado antes de utilizar o formulário revisto para notificações operacionais.
Quatro regras que impedem o mapeamento incorreto de parâmetros
1. A ordem dos campos determina os valores dos marcadores de posição
A integração envia os valores válidos pela ordem original dos campos. Renomear uma variável não move o seu valor para outro espaço reservado. Se a mensagem recebida inverter o site e o evento, verifique primeiro a sequência do formulário.
2.º Campos preenchidos adicionais podem tornar-se parâmetros
Outras variáveis incidentes com números de sequência iguais ou superiores a 3 são também incluídas quando preenchidas. Reveja todo o formulário, incluindo os campos não relacionados com o WhatsApp. Um valor extra antes dos parâmetros desejados pode alterar a contagem de parâmetros ou modificar o mapeamento.
3.º Os valores vazios são ignorados
Um campo em branco não reserva uma posição vazia. Os valores preenchidos posteriormente podem ser deslocados para a frente. No exemplo acima, deixar o campo "Local" em branco pode fazer com que a opção "Falha de energia" ocupe a primeira posição do parâmetro. Exija e preencha todos os valores necessários para o modelo selecionado.
4.º O código WhatsApp controla o fluxo de trabalho do modelo
Se o código do WhatsApp estiver em falta, vazio ou abaixo do número de sequência 3, a integração utilizará o texto da mensagem de saída do Everbridge e não adicionará as outras variáveis do incidente. Este descreve a montagem da mensagem; não há garantia de que uma mensagem alternativa será entregue pelo WhatsApp. Para este fluxo de trabalho padrão, forneça sempre o ID válido correto.
Resolução de problemas com mensagens de modelo do WhatsApp da Everbridge
A informação incorreta aparece num campo de exemplo. Compare a ordem dos parâmetros com o modelo aprovado. Verifique se existem valores em branco e campos elegíveis adicionais preenchidos antes de alterar a redação do modelo.
Falta um campo na mensagem. Confirme se tem um valor, se aparece no formulário do operador e se tem um número de sequência real de, pelo menos, 3. Se for uma variável de seleção múltipla, lembre-se que apenas o primeiro valor é lido.
A integração está a utilizar o texto de saída em vez da string de modelo pretendida. Verifique o nome exato da variável "WhatsApp Code", o ID copiado e o número de sequência. Não utilize o ID do cabeçalho do modelo de incidente Everbridge.
A pré-visualização do Everbridge parece correta, mas o WhatsApp apresenta um comportamento diferente. Inspecione o código WhatsApp e os valores do formulário. Um ID válido e preenchido seleciona o modelo do WhatsApp independentemente das edições efetuadas no texto enviado.
A mensagem esperada do WhatsApp não chegou. Verifique novamente o método de entrega selecionado, o perfil de integração, os destinatários e o modelo aprovado, para além da configuração do formulário. A configuração correta dos parâmetros por si só não garante o caminho completo da entrega.
Perguntas frequentes
O que é o código do WhatsApp no Everbridge?
Trata-se da variável de incidente utilizada pela integração do ChatArchitect para armazenar o ID do modelo de mensagem do WhatsApp. O seu nome deve ser exatamente "Código WhatsApp" e o seu número de sequência deve ser 3 ou superior.
Devo envolver os valores dos incidentes entre chavetas?
Não. Introduza os valores dos parâmetros como texto simples. A integração adiciona os parêntesis rectos. O ID do modelo é diferente: preserve os parêntesis rectos exatamente como foram copiados do ChatArchitect.
Os campos de parâmetros podem vir antes do código WhatsApp?
Sim. O comportamento revisto inclui campos de parâmetros não vazios elegíveis, mesmo quando precedem o ID. Os seus números de sequência devem ainda ser 3 ou superiores, e a sua ordem deve corresponder aos marcadores de posição do modelo.
Alterar a mensagem de saída seleciona um modelo diferente?
Não, quando é introduzido um código WhatsApp válido. Altere este ID para selecionar outro modelo aprovado e, em seguida, reveja o número e a ordem dos seus parâmetros.
O que devo atualizar num modelo de incidente antigo?
Adicione ou preencha o código WhatsApp, inclua todas as variáveis de parâmetro necessárias e verifique os seus números de sequência e ordem. A integração revista mantém uma alternativa em texto simples. A ChatArchitect anunciou separadamente a exigência de ID para envios de modelos a partir de 1 de agosto de 2025; copie sempre o ID correto para o fluxo de trabalho do modelo aqui descrito.
Prepare o seu fluxo de trabalho Everbridge WhatsApp com o ChatArchitect
Uma configuração de formulário fiável começa com um ID de modelo preciso e uma sequência de parâmetros previsível. Mantenha a tarefa do operador clara: selecionar o modelo pretendido, preencher todos os valores obrigatórios, rever os destinatários e verificar a mensagem recebida após as alterações de configuração.
Utilize o guia de configuração do modelo ChatArchitect Everbridge como referência. Se estiver a planear a sua integração, reveja os planos da API ChatArchitect WhatsApp Business e prepare uma mensagem de incidente de exemplo com os campos necessários para a sua equipa.
