Passar para o conteúdo principal

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

Resumo

Deseja 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 com clientes exatamente como um membro da sua equipe.

Nota:

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

  • Se você já usa o Astra e deseja conectá-lo ao Wati via Connect AI Agents, o complemento não é necessário. Você só precisa estar nos planos Pro ou Business do Wati para habilitar essa integração.

Dica: Você pode encontrar essa opção na página de Configurações > 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ê pode atribuir conversas a ele manualmente ou através de automações Wati.

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

Como seu agente de IA recebe mensagens de clientes

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

Seu agente de IA não ficará sobrecarregado com dados desnecessários - o Wati envia apenas eventos de conversas atribuídas especificamente ao seu agente de IA. Conversas gerenciadas 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 em conversas atribuídas ao seu Agente de IA.

Como seu agente de IA pode responder aos clientes

Assim que seu agente for registrado, um token de acesso dedicado será gerado. Você pode usar esse 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 usados para começar:

  1. /sendSessionMessage

    • Envie uma resposta de mensagem para um cliente.

  2. /getContacts

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

  3. /updateContactAttributes

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

  4. /updateChatStatus

    • Atualize o status do chat assim que seu agente de IA resolver uma conversa.

  5. /assignOperator

    • Reatribua um chat para 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 sua 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 do 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 Wati para rotear mensagens automaticamente para seu Agente de IA Personalizado.

Use seu agente de IA em um chatbot

Assim que seu agente de IA estiver conectado, você pode transferir uma conversa de chatbot para ele usando o nó Agente de IA Personalizado em Usar um Nó de IA no construtor de fluxos.

Para obter instruções de configuração, consulte como conectar um agente de IA a um fluxo de chatbot no Wati.

Perguntas Frequentes (FAQs)

Visão Geral

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

O recurso Connect AI Agents permite integrar 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 com 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 $100 USD por mês. No entanto, se você já estiver usando o Astra, o complemento não é necessário. Você só precisa estar nos planos Pro ou Business do Wati para conectar o Astra ao Wati por meio 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 receber conversas atribuídas manualmente ou por meio de automações 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 mensagens relevantes para o agente de IA por meio 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 gerenciadas 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?

Os Agentes de IA Personalizados podem receber atualmente 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 é recebida em uma conversa atribuída ao agente de IA.

Respondendo aos 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 contato, atualizar atributos de contato, atualizar status de chat, reatribuir conversas a operadores humanos, acessar o histórico de conversas e baixar arquivos de mídia enviados pelos 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 pelos clientes?

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

Artigos relacionados
Respondeu à sua pergunta?