Introdução Webhook de Entrada

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:

  1. 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.

d2bd7193-a704-4beb-bf46-14a9afa72de1.png
  1. 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.

 

0af5c6df-75ae-4269-9df3-4a163899afb3.png
  1. 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.