Resumo
Quer atribuir automaticamente os chats recebidos ao proprietário de vendas correto no Wati? Este guia mostra 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.
Nota: Este recurso exige o plano Pro ou Business no Wati.
Instruções
Visão Geral da Solução
Você configurará um chatbot no Wati que fará o seguinte quando um usuário iniciar uma conversa:
Verifica se o usuário existe no Zoho CRM usando seu número de telefone.
Se o usuário existir:
Recupera o Proprietário do Lead do Zoho.
Atribui o chat a esse Proprietário do Lead no Wati.
Se o usuário não existir:
Envia uma mensagem de boas-vindas.
Se o token da API do Zoho tiver expirado:
Renova o token e tenta novamente.
Como Configurar o Chatbot e 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 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 no Passo 3 (Chamada de API).
Se não → Prossiga para obter um novo token (explicado posteriormente).
3. Pesquisar Lead no Zoho CRM
Faça uma chamada de API para o endpoint "Search Records" do Zoho CRM.
Passe o número de telefone do usuário para verificar se ele é um lead existente.
4. Lidar com Respostas da API
Código de Status | O Que Significa | Ação a Ser Tomada |
200 (Sucesso) | Um lead existe e a resposta inclui o nome do Proprietário do Lead. | Use "Definir uma Condição" + "Atribuir Agente" para encaminhar o chat para o Proprietário do Lead. |
204 (Sem Conteúdo) | Nenhum lead existe para este número de telefone (novo usuário). | Trate-os como um novo lead e prossiga com o fluxo padrão do seu chatbot. |
401 (Não Autorizado) | O token de acesso expirou. |
|
Use o Endpoint de Renovação de 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 renovado.
Passos para Configurar Isso
1. Baixar o Modelo do Chatbot
Baixe o modelo de chatbot pronto para uso: Check Zoho Lead Owner and Assign 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 em 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 fluxo do seu 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á possui um token de acesso para o Zoho CRM, pule para o Passo 5.
Para gerar um novo Token de Acesso:
Vá para o Console de API do Zoho: api-console.zoho.com
Crie um Self Client para obter seu:
client_idclient_secretcode
Use o seguinte comando para gerar seu token de acesso:
curl --location --request POST 'https://accounts.zoho.com/oauth/v2/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'grant_type=authorization_code' \ --data-urlencode 'client_id=<Enter Client ID>' \ --data-urlencode 'client_secret=<Enter Client Secret>' \ --data-urlencode 'code=<Enter Code>'
Seu token será assim:Zoho-oauthtoken 1000.xxxxxxxxxxx.xxxxxxxxxxxx
5. Adicionar o Token de Acesso ao Segundo Nó de Webhook
No segundo nó de webhook:
Vá para Personalizar 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 em seu 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 corresponde ao nome de um agente no Wati.
Se corresponder, 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 de Acesso 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' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'grant_type=refresh_token' \ --data-urlencode 'client_id=<Enter Client ID>' \ --data-urlencode 'client_secret=<Enter Client Secret>' \ --data-urlencode 'refresh_token=<Enter Refresh Token>'
Salve o novo token em um contato fictício (por exemplo,
22222222) no Wati.O chatbot usará este token para execuções futuras.
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 novos usuários suavemente com uma mensagem de boas-vindas.
Manter a gestão do token do Zoho automatizada.
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 os chats recebidos 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 este recurso?
Este recurso exige 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 do Lead associado ao usuário e atribui o chat a esse proprietário 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ção
5. Onde posso obter o modelo de chatbot para esta configuração?
Você pode baixar o modelo de chatbot pronto para uso Check Zoho Lead Owner and Assign Chat.json fornecido no guia.
6. Como importar o modelo de chatbot no Wati?
Vá para Automação > Chatbots em sua conta do Wati, clique em Importar JSON e carregue o modelo baixado.
7. Quais detalhes 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 gerar um novo Token de Acesso do Zoho CRM?
Vá para o Console de API do Zoho (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.
Gestão 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 a 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 ele corresponde ao nome de um agente no Wati. Se corresponder, 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 que os usuários fornecem.
O nome do Proprietário do Lead no Zoho corresponde ao 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 expirar.