Introdução Webhook de Entrada
- Equipe de Suporte
Webhooks são um recurso poderoso no Wiichat que permite que você integre sua própria plataforma com a automação de chat do Wiichat. Isso é útil se você tem sua própria plataforma de chat ao vivo e quer aproveitar os recursos de automação do Wiichat sem direcionar os usuários para a interface do Wiichat.
Quem deve usar Webhooks?
Webhooks são projetados para desenvolvedores que têm sua própria plataforma e alguma experiência trabalhando com APIs.
Como configurar Webhooks no Wiichat
Aqui está um guia passo a passo sobre como configurar webhooks no Wiichat:
Configure sua URL do Webhook:
Vá para Integrações e depois Webhooks.
Opcionalmente, você pode configurar seus próprios cabeçalhos para segurança adicional.
Forneça um URL de Webhook onde você deseja receber os dados.
Habilite Webhooks nas configurações do seu canal:
Acesse as configurações do canal do chat que você deseja integrar à sua plataforma (por exemplo, WhatsApp, SMS).
Em Configurações de chat ao vivo, selecione Webhook.
Use a ação Pausar o Bot:
No seu fluxo do Wiichat, inclua a ação Pausar o bot, onde você deseja que a conversa mude para sua plataforma.
Quando um usuário interagir depois desse ponto, a mensagem será enviada para o URL do seu Webhook.
Exemplo de carga útil
Os dados que o Wiichat envia para sua URL do Webhook são um payload JSON que inclui vários detalhes sobre a mensagem e a conversa. Aqui está uma análise do payload de exemplo na imagem:
meta
user_ns: Este é um identificador exclusivo para o usuário.
agent_id: Este é o ID do agente atualmente atribuído à conversa (0 indica que não há agente atribuído).
flow_ns: Este é um identificador exclusivo para o fluxo de bate-papo.
team_id: Este é o ID da equipe à qual o chat pertence.
mensagem
_id: Este é um identificador exclusivo para a mensagem.
mid: Este é um identificador exclusivo para a mensagem dentro do canal.
tipo: indica o tipo de mensagem (por exemplo, "in" para mensagem recebida).
msg_type: especifica o tipo de conteúdo da mensagem (por exemplo, "texto").
sender_id: Este é o ID do remetente da mensagem.
agent_id: Este é o ID do agente que recebeu a mensagem (0 indica que não há agente atribuído).
assigned_agent_id: Este é o ID do agente atribuído à conversa após o recebimento da mensagem.
carga útil
texto: contém o conteúdo textual da mensagem.
conteúdo: também contém o conteúdo textual da mensagem.
nome de usuário: Este é o nome de usuário do remetente da mensagem.
data: mostra a data em que a mensagem foi enviada.
timestamp: Este é o registro de data e hora da mensagem em milissegundos.
ts: Esta é outra representação de registro de data e hora da mensagem.
is_delivered: indica se a mensagem foi entregue (1 significa entregue).
visto: Este campo está vazio na carga útil de amostra, mas pode indicar se a mensagem foi vista.
Usando a API do Wiichat
Depois de capturar a mensagem do usuário em sua plataforma, você pode usar a API do Wiichat para enviar uma resposta de volta ao usuário dentro da conversa de chat. A API do Wiichat usa user_ns e flow_ns do payload para identificar a conversa e enviar a mensagem.
Considerações adicionais
Webhooks são uma ferramenta poderosa, mas exigem experiência em desenvolvimento.
O Wiichat suporta vários tipos de mensagens, e a carga útil refletirá o tipo de conteúdo (texto, imagem, etc.).
Aproveite a API do Wiichat para se comunicar entre sua plataforma e os usuários do Wiichat.
Seguindo essas etapas e entendendo os dados de carga útil, você pode configurar webhooks com sucesso para integrar sua própria plataforma com os recursos de automação do Wiichat.