Webhooks de entrada

O QUE SÃO WEBHOOKS DE ENTRADA

Webhooks são chamadas de API automáticas configuradas para serem disparadas para acontecerem após eventos específicos, neste caso em serviços externos, chamando múltiplas funções do ZionTalk. Essas funções são efetuadas por um canal selecionado do sistemas, onde também é gerado um URL específico para aquele webhook que é como será chamado por outras serviços:

Exemplo: ao ser chamado pelo URL gerado, fará uma ação por meio do canal (46) 97606-9805.

(Atenção: Os webhook podem apenas ser chamados por meio de métodos POST)

JSON ESPERADO

Para configurar os dados que serão recebidos no webhook é necessário estruturar o JSON Base, da mesma maneira o serviço externo deve estruturá-los no corpo do método POST para que sejam mapeados corretamente para o ZionTalk:

(É possível copiar o nome das variáveis clicando na lista de campos detectados)

Caso o JSON Base esteja estruturado de maneira incorreta como a falta de aspas ou vírgulas, o campo de “Campos detectados” sumirá, requisitando a correção do JSON.+

Exemplo: Foi removido uma aspas no antes do campo mensagem e a vírgula após o nome do arquivo, o que resultou na falha dos campos detectados.

MAPEAMENTO DE CAMPOS

Com o JSON estruturado corretamente, é necessário mapear os dados recebidos para as variáveis que serão utilizadas nas ações do webhook, para isso é necessário escolher ao menos um identificador, que pode ser um e-mail ou um telefone. Para completar os campos pode ser digitado manualmente ou clicando no campo em questão e selecionando na lista de campos detectados.

AÇÕES DO WEBHOOK

Com as configurações de recebimento de dados do webhook devidamente configuradas, é possível escolher as ações que serão executadas com esses dados após a chamada do URL. Múltiplas ações podem ser executadas por chamada de webhook:

Sendo as possíveis ações:

Cada uma das ações requer filtros/requisitos diferentes para a execução:

• Adicionar/remover contato de uma lista

  • Filtro: A lista em que o contato foi adicionado/removido

• Adicionar/remover uma etiqueta de um contato

  • Filtro: A etiqueta que for atribuída/removida

• Executar automação

  • Filtro: A automação atribuída

ENVIAR UMA MENSAGEM

Diferente das outras opções, para enviar uma mensagem é necessário estruturar a resposta, por meio de “Templates de Mensagens” ou manualmente. É possível a criação de menus de opções e anexar arquivos padrão para as mensagens. Também será gerada uma prévia da mensagem: