Resumo

Quer implementar seu próprio agente de IA personalizado no Wati? Com o recurso Connect AI Agents, você pode integrar seu agente de IA diretamente ao Wati como um agente de IA personalizado. Isso permite que seu agente trabalhe ao lado de seus operadores humanos - recebendo, respondendo e gerenciando conversas de clientes como um membro de sua equipe.

Nota:

O recurso Connect AI Agents é oferecido como um complemento pago (US$ 100/mês) para clientes Wati.

Se você já está usando o Astra e deseja conectá-lo ao Wati via Connect AI Agents, o complemento não é necessário. Você só precisa estar no plano Pro ou Business do Wati para habilitar esta integração.

Dica: Você pode encontrá-lo em Configurações > página Gerenciamento de Usuários no 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 ao Wati

Você pode registrar seu agente de IA como um Agente de IA Personalizado 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 Agente de IA Personalizado aparecerá na lista de operadores da Caixa de Entrada da Equipe, e você poderá 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 Agente de IA Personalizado 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 mensagem relevantes para seu agente de IA através 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 de entrada para conversas que estão atribuídas ao seu Agente de IA.

Como seu agente de IA pode responder aos clientes

Depois que seu agente for 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 chat.

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:

/sendSessionMessage
- Enviar uma resposta de mensagem a um cliente.
/getContacts
- Recuperar detalhes de contato (como número de telefone e atributos personalizados) quando uma conversa é atribuída ao seu agente de IA.
/updateContactAttributes
- Armazenar novas informações coletadas durante uma conversa como atributos de contato no Wati.
/updateChatStatus
- Atualizar o status do chat assim que seu agente de IA resolver uma conversa.
/assignOperator
- Reatribuir um chat a um operador humano se seu agente de IA não puder lidar com ele.

Acessando 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 de arquivo no evento de webhook. Seu agente de IA pode usar a API /getMedia para baixar o arquivo e processá-lo de acordo.

Onde encontrar seu Agente de IA Personalizado

Após a configuração, seu Agente de IA Personalizado aparece na lista de operadores da Caixa de Entrada da Equipe, onde pode receber chats como qualquer outro membro da equipe.

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

Perguntas Frequentes (FAQs)

Visão Geral

1. O que é o recurso Connect AI Agents no Wati?

O recurso Connect AI Agents permite que você integre seu próprio agente de IA personalizado ao Wati. O agente de IA pode trabalhar ao lado de operadores humanos recebendo, respondendo e gerenciando conversas de clientes dentro do Wati.

2. O recurso Connect AI Agents está incluído nos planos do Wati?

Não. O recurso Connect AI Agents está disponível como um complemento pago que custa US$ 100 por mês. No entanto, se você já está usando o Astra, o complemento não é necessário. Você só precisa estar no plano Pro ou Business do Wati para conectar o Astra ao Wati através do Connect AI Agents.

3. Como adiciono e atribuo um Agente de IA Personalizado no Wati?

Você pode registrar seu agente de IA como um Agente de IA Personalizado no Wati em Configurações > Gerenciamento de Usuários. Após a configuração, o agente de IA aparece na lista de operadores da Caixa de Entrada da Equipe e pode ter conversas atribuídas manualmente ou através de automações do Wati.

Recebendo mensagens de clientes

4. Como um Agente de IA Personalizado recebe mensagens de clientes?

Para receber mensagens de clientes, você deve fornecer uma URL de webhook ao Wati. O Wati envia eventos de mensagem relevantes para o agente de IA através do webhook.

5. Quais conversas acionam eventos de webhook para um Agente de IA Personalizado?

O Wati envia eventos de webhook apenas de conversas que são atribuídas ao Agente de IA Personalizado. Conversas tratadas por operadores humanos não acionam eventos de webhook para o agente de IA.

6. Quais eventos de webhook são suportados para Agentes de IA Personalizados?

Agentes de IA Personalizados podem atualmente receber dois eventos de webhook:

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

Respondendo a clientes e gerenciando conversas

7. O que um Agente de IA Personalizado pode fazer usando as APIs do Wati?

Um Agente de IA Personalizado pode usar seu token de acesso dedicado para interagir com as APIs públicas do Wati. Ele pode enviar mensagens, recuperar informações de contatos, atualizar atributos de contatos, atualizar status de chats, reatribuir conversas a operadores humanos, acessar histórico de conversas e baixar arquivos de mídia enviados por clientes.

8. Como um Agente de IA Personalizado pode acessar o histórico de conversas?

Quando um Agente de IA Personalizado é atribuído a um chat, ele pode usar o endpoint da API /getMessages para recuperar o contexto histórico da conversa. Isso ajuda o agente de IA a gerar respostas mais precisas e contextuais.

9. Como um Agente de IA Personalizado pode lidar com arquivos de mídia enviados por clientes?

Quando um cliente envia uma imagem, documento ou nota de voz, o Wati inclui o nome do arquivo no evento de webhook. O Agente de IA Personalizado pode então usar o endpoint da API /getMedia para baixar e processar o arquivo de mídia.

Como usar o recurso Conectar Agentes de IA para conectar e gerenciar seus próprios agentes de IA no Wati