Resumo
Deseja atribuir automaticamente os chats entrantes ao proprietário de vendas correto no Wati? Este guia ensina como verificar se um usuário já existe no Zoho CRM e atribuir seu chat ao Proprietário de Lead correto. Se o usuário for novo, você pode enviar uma mensagem de boas-vindas. Essa configuração ajuda a garantir respostas mais rápidas e uma melhor experiência do cliente.
Observação: Este recurso requer o plano Pro ou Business no Wati.
Instruções
Visão Geral da Solução
Você configurará um chatbot no Wati que faz o seguinte quando um usuário inicia uma conversa:
Verifica se o usuário existe no Zoho CRM usando o número de telefone.
Se o usuário existir:
Recupera o Proprietário de Lead do Zoho.
Atribui o chat a esse Proprietário de Lead no Wati.
Se o usuário não existir:
Envia uma mensagem de boas-vindas.
Se o token da API do Zoho expirar:
Atualiza o token e tenta novamente.
Como Configurar o Chatbot & Atribuir Conversas
1. Configuração Padrão do Chatbot
Configure o chatbot para iniciar automaticamente sempre que um usuário iniciar uma nova conversa.
2. Verificar o Token de Acesso Armazenado
O sistema verifica se um token de acesso (necessário para chamadas de API) já está salvo nos Atributos Personalizados do contato.
Se o token existir → Use-o em Passo 3 (Chamada de API).
Se não → Prossiga para obter um novo token (explicado mais adiante).
3. Pesquisar Lead no Zoho CRM
Faça uma chamada de API para o endpoint "Pesquisar Registros" do Zoho CRM.
Passe o número de telefone do usuário para verificar se é um lead existente.
4. Lidar com Respostas da API
Código de Status | O que isso significa | Ação a ser tomada |
200 (Sucesso) | Um lead existe e a resposta inclui o nome do Proprietário de Lead. | Use "Definir uma Condição" + "Atribuir Agente" para rotear o chat para o Proprietário do Lead. |
204 (Sem Conteúdo) | Nenhum lead existe para esse número de telefone (novou usuário). | Trate-os como um novo lead e prossiga com o fluxo padrão do chatbot. |
401 (Não Autorizado) | O token de acesso expirou. | Renove o token de acesso antes de fazer novas chamadas de API. |
Use o endpoint Renovar Token de Acesso para obter um novo token.
Atualize o novo token nos Atributos Personalizados.
Repita o Passo 3 (Chamada de API) com o token atualizado.
Passos para Configurar Isso
1. Baixar o Modelo de Chatbot
Baixe o modelo de chatbot pronto para usar: Verificar Proprietário de Lead do Zoho e Atribuir Chat.json
Este modelo contém os fluxos necessários para conectar o Wati ao Zoho CRM.
2. Importar o Modelo no Wati
Vá para Automação > Chatbots na sua conta do Wati.
Clique em Importar JSON.
Carregue o modelo de chatbot baixado.
3. Atualizar Suas Informações da API do Zoho
No primeiro nó de webhook do seu fluxo de chatbot:
Atualize seu endpoint da API do Zoho.
Adicione seu Token de Acesso.
4. Gerar um Token de Acesso do Zoho CRM (Se Necessário)
Se você já tiver um token de acesso para o Zoho CRM, pule para o Passo 5.
Para gerar um novo Token de Acesso:
Acesse o Zoho API Console: api-console.zoho.com
Crie um Client Self para obter seu:
client_idclient_secretcodeUse o seguinte comando para gerar seu token de acesso:
curl --location --request POST 'https://accounts.zoho.com/oauth/v2/token?grant_type=authorization_code&client_id=<Enter Client ID>&client_secret=<Enter Client Secret>&code=<Enter Code>'
Seu token parecerá assim:Zoho-oauthtoken 1000.xxxxxxxxxxx.xxxxxxxxxxxx
5. Adicionar o Token de Acesso ao Segundo Nó de Webhook
No segundo nó de webhook:
Vá para Customizar Cabeçalhos.
Adicione seu Token de Acesso do Zoho CRM no campo Autorização.
6. Entender Como a Lógica do Chatbot Funciona
O chatbot usa a API do Zoho para pesquisar um usuário com base no número de telefone.
Caso 1: Usuário Existe no Zoho (Código de Status: 200)
A API retornará o Proprietário do Lead.
Use o nó Definir uma Condição para verificar se o Proprietário do Lead coincides com o nome de um agente no Wati.
Se coincide, use o nó Atribuir Agente para atribuir o chat a esse agente.
Caso 2: Usuário Não Existe no Zoho (Código de Status: 204)
Trate este usuário como novo.
Envie uma mensagem de boas-vindas.
Caso 3: Token Expirado (Código de Status: 401)
Use outro nó de webhook para renovar o token.
Faça uma chamada de API com seu
client_id,client_secreterefresh_token:
curl --location --request POST 'https://accounts.zoho.com/oauth/v2/token' \
-H 'Content-Type: application/json' \
-d '{
"grant_type": "refresh_token",
"client_id": "<Enter Client ID>",
"client_secret": "<Enter Client Secret>",
"refresh_token": "<Enter Refresh Token>"
}'Notas Finais
Esta configuração ajuda você a:
Atribuir automaticamente chats ao proprietário de vendas correto.
Fornecer uma melhor experiência ao cliente com respostas mais rápidas.
Lidar com usuários novos suavemente com uma mensagem de boas-vindas.
Mantenha o gerenciamento de tokens do Zoho automatizado.
Perguntas Frequentes (FAQs)
Perguntas Gerais
1. Qual é o propósito desta configuração de chatbot no Wati?
→ A configuração do chatbot ajuda a atribuir automaticamente chats entrantes ao Proprietário de Lead correto do Zoho CRM com base no número de telefone do usuário. Se o usuário não existir no Zoho CRM, o chatbot envia uma mensagem de boas-vindas.
2. Qual plano do Wati é necessário para usar esse recurso?
→ Esse recurso requer o plano Pro ou Business no Wati.
3. O que acontece se o usuário já estiver no Zoho CRM?
→ O chatbot recupera o Proprietário de Lead associado ao usuário e atribui o chat a esse proprietário de vendas no Wati.
4. O que acontece se o usuário não for encontrado no Zoho CRM?
→ O chatbot trata o usuário como novo e envia uma mensagem de boas-vindas.
Configuração e Configurações
5. Onde posso obter o modelo de chatbot para esta configuração?
→ Você pode baixar o modelo de chatbot pronto para uso Verificar Proprietário de Lead do Zoho e Atribuir Chat.json fornecido no guia.
6. Como faço para importar o modelo de chatbot no Wati?
→ Vá para Automação > Chatbots na sua conta do Wati, clique em Importar JSON e envie o modelo baixado.
7. Quais informações do Zoho CRM preciso configurar no chatbot?
→ Você precisa adicionar seu endpoint da API do Zoho e Token de Acesso nos nós de webhook relevantes do fluxo do chatbot.
8. Como faço para gerar um novo Token de Acesso do Zoho CRM?
→ Acesse o Zoho API Console (api-console.zoho.com), crie um Self Client e use o client_id, client_secret e code fornecidos para gerar o token de acesso usando o comando curl fornecido.
9. Onde devo adicionar o Token de Acesso do Zoho CRM no chatbot?
→ Adicione seu Token de Acesso no campo Autorização do segundo nó de webhook personalizando os cabeçalhos.
Gerenciamento de Tokens
10. O que acontece se o Token de Acesso do Zoho CRM expirar?
→ O chatbot detecta o código de status 401 Não Autorizado e usa a API de Renovação de Token do Zoho para gerar um novo Token de Acesso automaticamente.
11. Onde o novo Token de Acesso é salvo após a renovação?
→ O novo token é salvo em um contato fictício (por exemplo, número de telefone 22222222) no Wati para uso futuro.
Lógica do Chatbot
12. Como o chatbot decide qual agente atribuir um chat?
→ Se a resposta da API retornar o nome do Proprietário do Lead do Zoho CRM, o chatbot verifica se coincide com o nome de um agente no Wati. Se coincide, o chat é atribuído a esse agente.
13. O que acontece se não houver um agente correspondente no Wati?
→ Se nenhum agente correspondente for encontrado, você pode configurar o chatbot para seguir seu fluxo padrão, como enviar uma mensagem de boas-vindas ou atribuir o chat a um agente padrão.
Resolução de Problemas
14. O que devo fazer se o chatbot não atribuir chats corretamente?
→ Verifique se:
O Token de Acesso foi adicionado corretamente.
O formato do número de telefone no Zoho corresponde ao fornecido pelos usuários.
O nome do Proprietário do Lead no Zoho coincide com o nome do agente no Wati.
15. Como posso testar se a configuração do chatbot funciona corretamente?
→ Você pode simular uma conversa de usuário no Wati e verificar se o chatbot:
Identifica leads existentes no Zoho.
Atribui o chat ao agente correto.
Envia uma mensagem de boas-vindas a novos usuários.
Renova o token automaticamente se expirado.