Como usar o Callback Dinâmico de HSM no Ligo Bots

< 1 min

O callback dinâmico define em qual ponto do fluxo o bot deve continuar quando o cliente responde a uma mensagem ativa de WhatsApp (HSM). Isso garante que a jornada do cliente siga do ponto certo, sem começar do zero.

Como funciona

  • Por padrão, o WhatsApp inicia o fluxo quando o cliente manda mensagem.
  • Com HSM, a empresa inicia o contato. Se o cliente responder, o callback dinâmico indica onde o fluxo deve continuar.
  • Se não configurar o callback dinâmico, o bot começa o atendimento do início, prejudicando a experiência.

Disparo de HSM

Você pode disparar HSM por:

  • API (individual, integrando com gatilhos)
  • Broadcast (lista de contatos)
  • Ligo Journeys (réguas de comunicação)

Todos esses caminhos registram o callback dinâmico, se informado.

Recebimento de resposta

  • Se o cliente responder ao HSM dentro de 24h, o sistema verifica se existe callback dinâmico.
    • Se sim: a resposta vai para o ponto certo do fluxo.
    • Se não: começa do início.
  • Fora da janela de 24h, o fluxo começa do zero.

Variáveis externas

  • Você pode enviar variáveis externas no payload da API ao disparar o HSM.
  • Use o padrão ‎`external.nome` para nomear variáveis.
  • Inclua múltiplos parâmetros usando ‎`&` como separador.

Exemplo de payload:”callbackResponses”: “https://wapp.boteria.com.br/whatsapp/sendfycloud/message/<id_bot>?nome=Alan&protocolo=123”

Como encontrar a URL de callback dinâmico

  • O bot precisa ter canal WhatsApp ativo (apenas para contas pagas).
  • Acesse a aba Canais, clique no card do WhatsApp e confira se o provedor é Sendfy Cloud.
  • Role até encontrar as URLs de callback de mensagem e status. Copie para configurar na API.