Webhooks

Sistemas externos chamam webhook da Suri para iniciar um fluxo

É comum ERPs e outros sistemas possuírem o conceito de webhooks para notificar outros sistemas sobre algum acontecimento, por exemplo, um novo usuário cadastrou-se ou completou um funil de vendas. Com a Suri você também consegue receber tais webhooks e fazer com que o contato siga um fluxo desejado.

Na mesma tela de configuração de gatilhos, basta adicionar webhook

Webhooks de gatilho da Suri aceitam requisições POST com alguns modelos pré-definidos no BODY. Basta adicionar webhook na tela de configuração do fluxo, escolher um canal desejado e copiar a URL mostrada, este é o link do webhook que você usará em seu ERP ou outro sistema externo: ele que será chamado e ativará o fluxo.

Importante ressaltar que, como a Suri trabalha dentro de canais de mensageria, deve respeitar o identificador do canal em questão, telefone, no caso do WhatsApp. Então por isso devemos escolher o canal desejado para executar o fluxo. Além disso, o sistema que chama o webhook Suri deve, no mínimo, fornecer o telefone do contato contendo DDD e número (e DDI, caso seja um número internacional). Exemplos de números aceitos:

• 55 85 9 8877-6655 (DDI do Brasil - 55, DDD - 85 e número)

• 11 9 8877-6655 (DDD - 11 e número, consideramos como número brasileiro)

• 11.8877.6655 (também aceitamos números sem ou com as mais diversas formatações)

Funcionamento durante atendimento/espera

O que acontece quando um fluxo é engatilhado pelo webhook, mas o contato em questão já existe na Suri e está na fila Esperando ou Atendimento, ou seja, ele já foi transferido para atendimento humano em algum momento?

Como observado na imagem mais acima, existe um checkbox "Funcionar durante atendimento" que permite exatamente essa configuração. Por padrão ele está desmarcado, o que indica que se o contato já existir e estiver na fila Espera/Atendimento, o fluxo não será executado. Esta flag é útil para ser utilizada dependendo do contexto do seu webhook. Por exemplo:

• Alguns leads converteram em um evento no RD Marketing e o fluxo foi engatilhado, transferindo os contatos em questão para Esperando

• No outro dia, realizamos uma ação que tinha por objetivo enviar um E-book para todos que converteram no dia anterior. Note que, como os contatos serão exatamente os mesmos, eles tendem a estar no Esperando ou em Atendimento, por isso, é importante nesse fluxo a ser engatilhado deixar o checkbox marcado, garantindo o envio independente da fila.

Detalhe importante: se o fluxo possui gatilho de webhook com "Funcionar durante atendimento" marcado, mas contém ações de botões ou listas (que envolvem interação do contato), estas ações podem não ser realizadas em sua totalidade, pois a regra geral da Suri é não funcionar botões de fluxo nas filas Esperando/Atendimento. Em resumo: a ação de clicar nos botões não irá prosseguir com a execução do fluxo de conversa caso a pessoa esteja no Esperando/Atendimento.

Sessão da conversa

Caso o contato não exista no chatbot, ao receber o webhook, ele será importado utilizando o telefone recebido no BODY. Nesses casos, obviamente, o contato estará com a sessão de conversa fechada, só sendo possível enviar mensagens template.

Então caso tenha ciência de que a base de contatos que será ativada pode ter sessão fechada, faz-se necessário utilizar uma ou mais ações de envio de template no fluxo, como mostrado abaixo

Tipos aceitos

Pela imagem acima, além de ser necessário informar o canal WhatsApp que deverá receber o novo contato, vê-se que também é preciso escolher o TIPO de webhook, que basicamente diz respeito ao tipo de dado que será recebido no BODY da requisição. Fazemos essa distrinção para que seja possível estruturar os dados e poder utilizá-los posteriormente através de macros.

Estamos constantemente trabalhando para avançar os tipos de webhooks de gatilho existentes no fluxo, atualmente temos as seguintes possibilidades:

• RD Marketing, que permite realizar uma integração poderosa entre a Suri e a plataforma de automação de marketing mais usada no Brasil e

• Customizado, que permite integrar qualquer sistema externo com a Suri com uma simples chamada de Webhook. Esse é o tipo ideal caso seu CRM, ERP ou qualquer outro tipo de sistema que irá fazer as chamadas não esteja dentre as integrações nativas de webhook.