...
| Informações |
|---|
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 :
...
...
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 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 .
...
digite/cole manualmente aqui
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.
...
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:
verificar
user_nsse houver um
user_nsusuário válido, encontrado.se não, próximo passo
verificar
phone/emailse pudermos encontrar um usuário pelo
phoneouemail, usuário encontrado.se não, próximo passo
verificar
phonenenhum 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:
...
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.
...
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.