Configurando os Webhooks de Entrada

Owned by Equipe de Suporte
Last updated: nov. 14, 2024
6 min read

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.

 

Limitação - Cada bot tem até 5 webhooks de entrada, o limite de taxa é de 500 solicitações a cada 24 horas.

Criar Webhook de entrada

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

image-20241114-002819.png

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

image-20241114-002915.png

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.

Histórico 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;

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.