Skip to main content

Callback Dinâmico de HSM

O callback dinâmico é o processo que define em qual ponto do fluxo o chatbot deve continuar quando há uma resposta a uma mensagem ativa de WhatsApp (HSM), garantindo a continuidade da jornada. Sem ele, o atendimento começa do zero, seguindo o fluxo padrão do bot.

Visão geral​

O canal WhatsApp, por padrão, opera de forma receptiva — ou seja, o fluxo é iniciado pelo cliente. No entanto, ao utilizar mensagens ativas (HSMs), o fluxo se torna proativo, sendo iniciado pela empresa.

Quando um HSM é respondido, é necessário indicar ao sistema em qual ponto do fluxo do chatbot a conversa deve continuar, sinalizando que o cliente já está em uma jornada. Esse processo é chamado de callback dinâmico.

Caso essa indicação não seja feita, o chatbot iniciará o fluxo do começo, como se fosse uma nova interação, o que compromete a continuidade da jornada e prejudica a experiência do usuário.

Como funciona​

O fluxo de funcionamento do callback dinâmico no Ligo Bots é representado pelo esquema a seguir:

Fluxo

Ele descreve o envio e o tratamento de mensagens HSM dentro do sistema de mensageria da Ligo, com controle de callbacks dinâmicos para respostas personalizadas.

📤 Disparo de um HSM​

O processo começa com o disparo do HSM, que pode ser feito por três caminhos:

  • API (disparos individuais integrados a gatilhos de sistemas)
  • Broadcast (envios para uma lista de contatos, como realizado no Ligo Omni)
  • Ligo Journeys (envios por meio de réguas de comunicação)

Esses três caminhos convergem para uma etapa central, localizada na camada de mensageria, responsável pelo envio do HSM e, quando informado, pelo registro do callback dinâmico de retorno vinculado à sessão do cliente.

💬 Recebimento de Mensagem do Cliente​

Quando o cliente responde ao HSM dentro da janela de sessão (24h), o sistema verifica se existe uma sessão ativa com callback dinâmico associado.

✅ Se houver callback dinâmico: A resposta é encaminhada para o bot informado na url de callback.

❌ Se não houver callback dinâmico: A resposta é encaminhada para o callback padrão.

⚠️ IMPORTANTE! O callback dinâmico só será respeitado se a resposta ao HSM ocorrer dentro da janela de sessão de 24h. Caso contrário, a conversa será tratada como uma nova interação e o fluxo será iniciado do começo.

🤖 Variáveis externas do bot​

Todo HSM disparado via API pode incluir, no corpo da requisição (payload), informações que definem o destino da resposta (id do bot) e os dados que ela deve carregar, conforme modelo abaixo:

[
{
"numberchip": "5511999999999",
"telephone": "5511222222222",
"message": "Message text send example with dynamic callback"
"callbackResponses": "https://wapp.boteria.com.br/whatsapp/sendfycloud/message/< id_bot >?nome=Alan&protocolo=123"
"callbackStatus": "https://wapp.boteria.com.br/whatsapp/sendfycloud/status/< id_bot >?nome=Alan&protocolo=123"
}
]

Esses dados geralmente são identificadores do cliente — como CPF, campanha ou origem — e podem ser concatenados conforme a necessidade da aplicação. Além disso, o payload pode conter uma sinalização específica indicando que se trata de um HSM utilizado para iniciar uma jornada ativa, e não uma interação receptiva.

Essas informações são armazenadas no bot como variáveis externas. Por padrão, essas variáveis devem ser nomeadas com o prefixo external, conforme ilustrado na imagem abaixo.

Imagem 2

Pontos de atenção:​

  • As variáveis externas não são automáticas e podem ser utilizadas em qualquer lugar do fluxo.
  • Além do padrão “external.nome”, pode-se usar qualquer outro nome de variável disponível na URL de callback configurado.
  • Para incluir múltiplos parâmetros, utilize o caractere & como separador.
  • Para mais informações acesse nossa documentação de API: https://docwhatsapp.sendfy.io/?id=dynamic-callback

🔎 Como encontrar a URL de callback dinâmico no Ligo Bots​

Primeiramente, é necessário que o bot tenha o canal WhatsApp configurado, o que está disponível apenas para contas pagas.

Para verificar se o canal está ativo, acesse a aba Canais e confira o status do card correspondente ao WhatsApp.

Imagem 4

Com o canal de WhatsApp ativo, clique no card correspondente. Certifique-se de que o provedor selecionado seja o Sendfy Cloud.

Em seguida, role a página até localizar as URLs de callback de mensagem e callback de status. Copie esses links — eles serão utilizados nas configurações da API.

Imagem 5