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.

Open

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

Open

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