Conhecendo os Webhooks de Entrada

O webhook de entrada é uma ferramenta poderosa para receber dados de qualquer lugar para o chatbot por meio de uma solicitação POST.

Com webhooks de entrada, seu bot pode até iniciar uma conversa com um usuário de bot que nunca falou com ele antes.

Por exemplo, quando um cliente preenche suas informações de contato no seu site, você envia os dados para um webhook de entrada de um chatbot, digamos um SMS bot. O SMS bot pode então enviar uma mensagem de confirmação para o número de telefone do cliente.

Se esse webhook for criado em um bot de voz, o bot poderá até ligar para o cliente imediatamente!

Aprenda neste artigo como criar e configurar webhooks na sua conta da WiiChat.

Criar Webhook de entrada

Ele está disponível em quase todos os canais. No seu criador de fluxo, vá em Ferramentas - Webhooks de entrada :

Open

Clique em Novo Webhook de entrada , dê um nome e clique em Salvar :

Open

Você verá a interface de edição assim:

Endereço do Webhook

Esta área mostra para onde enviar os dados e o método, que é POST. Cada webhook de entrada tem uma URL única em todo o sistema WiiChat.

Exemplo de JSON recebido

Esta área mostra um exemplo JSON para referência. Ele descreve a estrutura dos dados no JSON que recebemos depois. Precisamos dele para encontrar os valores para **identificação do usuário** e dados para salvar .

Há duas maneiras de obter um JSON de exemplo:

1. digite/cole manualmente aqui

2. ouça dados em tempo real de um teste ao vivo

Valores para identificar um usuário

Sempre que o webhook recebe dados, ele primeiro verifica os caminhos que você especifica aqui para ver se consegue encontrar um usuário existente no chatbot.

Se o usuário não estiver no sistema, o chatbot criará um novo perfil. É assim que o chatbot inicia uma conversa sem falar com o usuário antes.

No entanto, alguns canais não permitem que o chatbot inicie a conversa primeiro devido a problemas de privacidade e spam.

Por exemplo, seu bot de SMS pode enviar mensagens desde que você tenha o número de telefone do destinatário, enquanto seu chatbot do Facebook Messenger não pode enviar mensagens para um usuário do Facebook que nunca falou com seu bot antes.

Processo de identificação do usuário

Este é o processo de como o sistema identifica um usuário:

1. verificaruser_ns

   • se houver um user_nsusuário válido, encontrado.

   • se não, próximo passo

2. verificar phone/email

   • se pudermos encontrar um usuário pelo phoneou email, usuário encontrado.

   • se não, próximo passo

3. verificarphone

   • nenhum usuário corresponde ao sistema, o phonenúmero é válido?

   • se sim, perfil de usuário criado.

   • caso contrário, o webhook não será processado

Área de mapeamento

A lista de mapeamento mostra qual valor deve ser armazenado em qual campo personalizado. Quando você obtiver um JSON de amostra na área acima, clique em Preview Payload para obter uma ferramenta de mapeamento.

Registros de Webhook

Cada solicitação é salva em Logs . Clique em um registro para ver os dados JSON recebidos.

Limitação de Webhook de entrada

Por padrão, os limites de solicitação de webhook de entrada são 500 solicitações por 24 horas. Você pode ver os limites na captura de tela abaixo:

Se você excedeu os limites, você tem a opção de fazer upgrade para mais solicitações por dia. Aqui está uma lista das opções que você tem:

• 500/dia - Incluído ~~ 15K solicitações/por mês

• 1000/dia - R$200 por mês ~~ 30K solicitações/por mês

• 2000/dia - R$400 por mês ~~ 60K solicitações/por mês

• 3000/dia - R$600 por mês ~~ 90K solicitações/por mês

• 4000/dia - R$800 por mês ~~ 120K solicitações/por mês

• 5000/dia - R$1000 por mês ~~ 150K solicitações/por mês

• 10000/dia - R$2000 por mês ~~ 300K solicitações/por mês

Faça sua solicitação em: contato@wiichat.com.br

O link custa RS$ 200 por mês por unidade. Se você precisar de 1.000 solicitações por dia, basta selecionar a quantidade 1;

Se você precisar de 2.000 solicitações por dia, basta selecionar a quantidade 2, etc.

Após o pagamento, você precisa fornecer seu recibo de pagamento e seu flowNS para o e-mail de suporte do WiiChat em contato@wiichat.com.br

Veja como você pode encontrar seu flowNS,

Vá para “Todos os bots” no painel do WiiChat e, em seguida, encontre o bot para o qual deseja aumentar os limites de solicitação de webhook de entrada e, em seguida, clique no menu suspenso, você encontrará o flowNS .

Como depurar erro de solicitação máxima de webhook de entrada

Primeiro, se você não estiver recebendo os dados no webhook de entrada ou não conseguir encontrar os dados nos logs, é bem possível que você tenha atingido o limite máximo de solicitações diárias.

Veja como você pode testá-lo.

Você pode enviar a solicitação para o webhook de entrada do Postman ou uma solicitação externa do WiiChat e, então, poderá encontrar as informações abaixo no cabeçalho:

Como você pode ver, há um limite de taxa restante. Se for 0, significa que você já atingiu os limites de taxa e deve fazer upgrade para mais limites.

Demonstração: Confirmação de reserva

Uma ferramenta perfeita para testar seu webhook de entrada já está embutida em todos os lugares! Simplesmente pegue um chatbot (qualquer canal), teste-o em um Action Step .

Abra outra página da Web do WiiChat lado a lado, mantenha a edição do webhook de entrada na Página 1 e selecione uma solicitação externa na Página 2:

Siga os passos 1 a 8 na captura de tela a seguir:

Forneça os dados que precisam ser enviados ao chatbot e clique em Testar , você deve obter um erro "webhook inativo", pois ainda não o ativamos. Tudo bem, clique em Concluído na Página 1, e você verá os dados salvos:

Role um pouco para baixo, siga os passos 1, 2, 3 para informar ao sistema onde estão os valores phonee emailno JSON:

Por fim, mapeie os dados restantes para o chatbot:

Salve sua edição de webhook de entrada:

Entre no subfluxo, vamos enviar uma mensagem ao usuário do bot:

Publique o fluxo e vamos fazer um teste ao vivo na solicitação externa novamente:

Podemos ver que dessa vez ele rodou sem erro porque ativamos o webhook e usamos um número de telefone real. Vá para Logs e podemos ver que um novo perfil de usuário foi criado com sucesso.