Passar para o conteúdo principal

Como usar Bring Your Own AI (BYOA) para conectar e gerenciar seus próprios agentes de IA no Wati

Atualizado hoje

Resumo

Deseja implantar seu próprio agente de IA personalizado no Wati? Com o recurso Bring Your Own AI (BYOA), você pode integrar seu agente de IA diretamente ao Wati como um operador de IA. Isso permite que seu agente trabalhe ao lado de seus operadores humanos - recebendo, respondendo e gerenciando conversas com clientes como um membro da sua equipe.

Bring Your Own AI (BYOA) recurso está atualmente em Beta e disponível como um add-on no plano Business do Wati. Taxas serão aplicadas quando sair da Beta.

Você pode encontrá-lo na página de Gestão de Usuários do Wati!

Instruções

Siga este guia para entender como seu agente de IA pode enviar e receber mensagens, gerenciar o contexto do chat e interagir com o Wati usando APIs.

Adicione seu agente de IA personalizado ao Wati

Você pode registrar seu agente de IA como um operador de IA no Wati. Uma vez adicionado, seu agente receberá um token de acesso dedicado que permite interagir com as APIs públicas do Wati - como enviar mensagens, atualizar contatos ou resolver chats.

Seu operador de IA aparecerá na lista de operadores da caixa de entrada da equipe, e você pode atribuir conversas a ele manualmente ou por meio de automações do Wati.

Por exemplo, você pode criar uma regra de automação para atribuir todos os novos chats ao seu operador de IA automaticamente.

Como seu agente de IA recebe mensagens de clientes

Para receber mensagens, forneça uma URL de webhook ao Wati. O Wati enviará eventos de mensagens relevantes para seu agente de IA por meio deste webhook.

Seu agente de IA não será sobrecarregado com dados desnecessários — o Wati envia apenas eventos de conversas atribuídas especificamente ao seu agente de IA. Conversas tratadas por operadores humanos não acionarão eventos de webhook para seu agente.

Eventos de webhook suportados

Atualmente, seu agente de IA pode receber 2 tipos de eventos de webhook:

  • Chat Atribuído – Acionado quando um chat é atribuído ao seu agente de IA.

  • Mensagem Atribuída Recebida - Acionado quando há uma nova mensagem recebida para conversas que são atribuídas ao seu Agente de IA.

Como seu agente de IA pode responder aos clientes

Uma vez registrado, um token de acesso dedicado será gerado. Você pode usar este token de acesso dedicado com as APIs públicas do Wati para enviar mensagens, atualizar informações de contato ou gerenciar status de chats.

Você pode encontrar a lista completa de APIs na documentação da API do Wati.

Aqui estão os endpoints mais comumente usados para começar:

  1. /sendSessionMessage

    • Enviar uma resposta de mensagem para um cliente.

  2. /getContacts

    • Recuperar detalhes de contato (como número de telefone e atributos personalizados) quando uma conversa é atribuída ao seu agente de IA.

  3. /updateContactAttributes

    • Armazenar novas informações coletadas durante uma conversa como atributos de contato no Wati.

  4. /updateChatStatus

    • Atualizar o status do chat uma vez que seu agente de IA resolve uma conversa.

  5. /assignOperator

    • Reatribuir um chat a um operador humano se seu agente de IA não puder lidar com ele.

Acessando o histórico de conversas

Quando seu agente de IA é atribuído a um chat, ele pode recuperar o contexto histórico usando o endpoint da API /getMessages. Isso ajuda seu IA a gerar respostas mais precisas e contextuais com base em mensagens passadas e recentes.

Lidando com mensagens de mídia

Se um cliente enviar uma imagem, documento ou nota de voz, o Wati incluirá um nome do arquivo no evento de webhook. Seu agente de IA pode usar a API /getMedia para baixar o arquivo e processá-lo conforme necessário.

Onde encontrar seu operador de IA

Após a configuração, seu operador de IA aparece na lista de operadores da caixa de entrada da equipe, onde pode ser atribuído a chats assim como qualquer outro membro da equipe.

Você também pode usar automações do Wati para rotear mensagens automaticamente para seu operador de IA.

Perguntas Frequentes (FAQs)

Perguntas gerais

1. O que é o recurso Bring Your Own AI (BYOA)?

O recurso Bring Your Own AI (BYOA) permite que você integre seu próprio agente de IA personalizado ao Wati como um operador de IA. Uma vez adicionado, seu agente de IA pode enviar e receber mensagens, gerenciar o contexto do chat e interagir com o Wati por meio de APIs públicas.

2. Quem pode acessar o recurso BYOA?

O recurso BYOA está atualmente disponível como um add-on para usuários do plano Business do Wati. Está em Beta, e taxas serão aplicadas quando for lançado oficialmente.

3. Onde posso encontrar a opção BYOA no Wati?

Você pode encontrar o recurso Bring Your Own AI na página de Gestão de Usuários do Wati.

Configuração e configuração

4. Como adiciono meu agente de IA personalizado ao Wati?

Você pode registrar seu agente de IA como um operador de IA no Wati. Uma vez registrado, ele recebe um token de acesso dedicado para interagir com as APIs públicas do Wati para tarefas como enviar mensagens, atualizar contatos e gerenciar status de chats.

5. Como atribuo chats ao meu agente de IA?

Seu operador de IA aparece na lista de operadores da caixa de entrada da equipe. Você pode atribuir chats manualmente ou usar regras de automação do Wati para atribuir conversas automaticamente.

Manuseio de mensagens e API

6. Como meu agente de IA recebe mensagens de clientes?

O Wati envia eventos de mensagens para seu agente de IA por meio de uma URL de webhook que você fornece. Apenas conversas atribuídas ao seu agente de IA acionam eventos de webhook — chats tratados por operadores humanos são excluídos.

7. Quais tipos de eventos de webhook são suportados?

Seu agente de IA pode atualmente receber dois tipos de eventos de webhook:

  • Chat Atribuído – Acionado quando um chat é atribuído ao seu agente de IA.

  • Mensagem Atribuída Recebida – Acionado quando uma nova mensagem é recebida em um chat atribuído ao seu agente de IA.

8. Como meu agente de IA pode responder aos clientes e gerenciar conversas?

Seu agente de IA pode usar as APIs públicas do Wati com seu token de acesso para enviar mensagens (/sendSessionMessage), recuperar contatos (/getContacts), atualizar atributos (/updateContactAttributes), resolver chats (/updateChatStatus) ou reatribuí-los a operadores humanos (/assignOperator).

9. Como meu agente de IA pode lidar com mídia e acessar o histórico de chat?

Se um cliente enviar um arquivo, o Wati inclui um nome de arquivo no evento de webhook. Seu agente de IA pode usar a API /getMedia para baixá-lo. Para mensagens antigas, ele pode usar /getMessages para acessar o histórico de chat e manter o contexto.

Automação e gerenciamento de equipe

10. Posso automatizar o roteamento de chats para meu operador de IA?

Sim. Você pode usar as regras de automação do Wati para rotear automaticamente novos ou chats específicos para seu operador de IA, assim como atribuir chats a qualquer outro membro da equipe.

Respondeu à sua pergunta?