Webhook 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!
Limitação
Cada bot tem até 5 webhooks de entrada.
Criar Webhook de entrada
Ele está disponível em quase todos os canais. No seu criador de fluxo, vá em **Ferramentas** - **Webhooks de entrada** :
Clique em **Novo Webhook de entrada** , dê um nome e clique em **Salvar** :
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 EscalaChat.
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. verificar`user_ns`
- se houver um `user_ns`usuário válido, encontrado.
- se não, próximo passo
2. verificar `phone`/`email`
- se pudermos encontrar um usuário pelo `phone`ou `email`, usuário encontrado.
- se não, próximo passo
3. verificar`phone`
- nenhum usuário corresponde ao sistema, o `phone`nú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.
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 EscalaChat 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.
EscalaChat © Copyright 2025. Todos os direitos reservados