Resumo
Quer implementar seu próprio agente de IA personalizado na Wati? Com o recurso Traga Sua Própria IA (BYOA), você pode integrar seu agente de IA diretamente na Wati como um operador de IA. 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.
Observação:
O recurso BYOA é oferecido como um add-on pago (US$ 100/mês) para clientes Wati.
Se você já usa o Astra e deseja conectá-lo à Wati via BYOA, o add-on não é necessário. Você só precisa estar no plano Pro ou Business da Wati para habilitar esta integração.
Você pode encontrá-lo na sua página de Gerenciamento de Usuários na 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 a Wati usando APIs.
Adicione seu agente de IA personalizado à Wati
Você pode registrar seu agente de IA como um operador de IA na Wati. Uma vez adicionado, seu agente receberá um token de acesso dedicado que lhe permite interagir com as APIs públicas da 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ê poderá atribuir conversas a ele manualmente ou por meio de automações da Wati.
Por exemplo, você pode criar uma regra de automação para atribuir todos os novos chats automaticamente ao seu operador de IA.
Como seu agente de IA recebe mensagens de clientes
Para receber mensagens, forneça uma URL de webhook para a Wati. A Wati enviará eventos de mensagem relevantes para seu agente de IA por meio desse webhook.
Seu agente de IA não será sobrecarregado com dados desnecessários - a Wati só envia 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 – Disparado quando um chat é atribuído ao seu agente de IA.
Mensagem Atribuída Recebida - Disparado quando há uma nova mensagem de entrada para conversas que são atribuídas ao seu Agente de IA.
Como seu agente de IA pode responder a clientes
Assim 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 da 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 da Wati.
Aqui estão os endpoints mais usados para começar:
/sendSessionMessageEnviar uma resposta de mensagem a um cliente.
/getContactsRecuperar detalhes de contato (como número de telefone e atributos personalizados) quando uma conversa é atribuída ao seu agente de IA.
/updateContactAttributesArmazenar novas informações coletadas durante uma conversa como atributos de contato na Wati.
/updateChatStatusAtualizar o status do chat assim que seu agente de IA resolver uma conversa.
/assignOperatorReatribuir 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, a 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 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 receber chats como qualquer outro membro da equipe.
Você também pode usar automações da Wati para rotear mensagens automaticamente para seu operador de IA.
Perguntas Frequentes (FAQs)
Visão geral
1. O que é o recurso Traga Sua Própria IA (BYOA) na Wati?
O recurso Traga Sua Própria IA (BYOA) permite que você integre seu agente de IA personalizado na Wati como um operador de IA que pode receber, responder e gerenciar conversas de clientes ao lado de operadores humanos.
2. O recurso BYOA é gratuito para usar?
O recurso BYOA é oferecido como um add-on pago que custa US$ 100 por mês para clientes Wati.
3. Existem requisitos de plano para usar BYOA com Astra?
Para conectar o Astra à Wati usando BYOA, você deve estar nos planos Pro ou Business da Wati.
4. Onde você pode encontrar o recurso BYOA na Wati?
O recurso BYOA está disponível na página Gerenciamento de Usuários na Wati.
Configuração e Atribuição
5. Como você adiciona e usa um agente de IA personalizado na Wati?
Você pode registrar seu agente de IA personalizado como um operador de IA na Wati. Uma vez registrado, o agente recebe um token de acesso dedicado para interagir com as APIs da Wati e aparece na caixa de entrada da equipe, onde as conversas podem ser atribuídas manualmente ou por meio de regras de automação.
6. Os chats podem ser atribuídos automaticamente ao agente de IA?
Sim, você pode criar regras de automação na Wati para atribuir automaticamente novos chats ao operador de IA.
Manuseio de Mensagens e Webhooks
7. Como o agente de IA recebe mensagens de clientes?
O agente de IA recebe mensagens por meio de uma URL de webhook fornecida à Wati, que envia eventos de mensagem relevantes para conversas atribuídas ao agente de IA.
8. Quais eventos de webhook o agente de IA suporta?
O agente de IA suporta dois eventos de webhook: "Chat Atribuído", acionado quando um chat é atribuído ao agente, e "Mensagem Atribuída Recebida", acionado quando uma nova mensagem é recebida em uma conversa atribuída.
9. O agente de IA recebe eventos de todas as conversas?
Não, o agente de IA só recebe eventos de webhook para conversas que são especificamente atribuídas a ele.
APIs e Recursos
10. Como o agente de IA pode interagir com clientes e gerenciar chats?
O agente de IA usa seu token de acesso dedicado com as APIs públicas da Wati para enviar mensagens, recuperar detalhes de contato, atualizar atributos de contato, gerenciar status de chat, reatribuir chats a operadores humanos, acessar histórico de conversas usando o endpoint /getMessages e baixar arquivos de mídia usando o endpoint /getMedia.