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 o chat dele ao "Lead Owner" (Proprietário do 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 ao cliente.

Nota: 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 realizará as seguintes ações quando um usuário iniciar uma conversa:

Verifica se o usuário existe no Zoho CRM usando o número de telefone dele.
Se o usuário existir:
- Recupera o "Lead Owner" do Zoho.
- Atribui o chat a esse "Lead Owner" no Wati.
Se o usuário não existir:
- Envia uma mensagem de boas-vindas.
Se o token da API do Zoho tiver expirado:
- Atualiza o token e tenta novamente.

Como configurar o Chatbot e atribuir conversas

1. Configuração padrão do Chatbot

Configure o chatbot para ser iniciado automaticamente sempre que um usuário começar 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 (Custom Attributes) do contato.
- Se o token existir → Use-o na Etapa 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 as respostas da API

Código de Status	O que significa	Ação a tomar
200 (Sucesso)	O lead existe e a resposta inclui o nome do Lead Owner.	Use "Set a Condition" + "Assign Agent" para direcionar o chat ao Lead Owner.
204 (Sem conteúdo)	Nenhum lead existe para este número de telefone (novo usuário).	Trate-o como um novo lead e continue com o fluxo padrão do seu chatbot.
401 (Não autorizado)	O token de acesso expirou.

Use o Endpoint para Atualizar Token de Acesso para obter um novo token.
Atualize o novo token nos Atributos Personalizados.
Tente novamente a Etapa 3 (Chamada de API) com o novo token.

Passos para configurar este Chatbot

1. Baixar o modelo de 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 para o Wati

Vá para Automation > Chatbots na sua conta Wati.
Clique em Import JSON.
Faça o upload do modelo de chatbot baixado.

3. Atualizar seus detalhes da API Zoho

No primeiro nó de webhook do seu fluxo de chatbot:

Atualize seu Endpoint da API 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 a Etapa 5.

Para gerar um novo Token de Acesso:

Vá para o console da API do Zoho: api-console.zoho.com
Crie um Self Client para obter seu:
- client_id
- client_secret
- code
Use o comando a seguir 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=<Insira o Client ID>' \
--data-urlencode 'client_secret=<Insira o Client Secret>' \
--data-urlencode 'code=<Insira o Código>'

Seu token será parecido com isto:Zoho-oauthtoken 1000.xxxxxxxxxxx.xxxxxxxxxxxx

5. Adicionar o Token de Acesso ao segundo nó de webhook

No segundo nó de webhook:

Vá para Customize Headers.
Adicione seu Token de Acesso do Zoho CRM no campo Authorization.

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 dele.

Caso 1: Usuário existe no Zoho (Código de Status: 200)

A API retornará o "Lead Owner".
Use o nó Set a Condition para verificar se o "Lead Owner" corresponde ao nome de um agente no Wati.
Se corresponder, use o nó Assign Agent 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 um novo cliente.
Envie uma mensagem de boas-vindas.

Caso 3: Token de Acesso expirado (Código de Status: 401)

Use outro nó de webhook para atualizar o token.
Faça uma chamada de API com seu client_id, client_secret e refresh_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=<Insira o Client ID>' \
--data-urlencode 'client_secret=<Insira o Client Secret>' \
--data-urlencode 'refresh_token=<Insira o Refresh Token>'

Salve o novo token em um contato fictício (por exemplo, 22222222) no Wati.
O chatbot usará este token para futuras execuções.

Conclusão

Esta configuração ajuda você a:

Atribuir chats automaticamente ao proprietário de vendas correto.
Proporcionar uma melhor experiência ao cliente com respostas mais rápidas.
Lidar com novos usuários de forma integrada com uma mensagem de boas-vindas.
Manter o gerenciamento de tokens do Zoho automatizado.

Perguntas Frequentes (FAQs)

Geral

1. O que essa configuração de chatbot faz?

O chatbot verifica se um usuário existe no Zoho CRM usando o número de telefone. Se o usuário existir, ele recupera o "Lead Owner" e atribui o chat ao agente correspondente no Wati. Se o usuário não existir, envia uma mensagem de boas-vindas. Se o token de acesso do Zoho CRM expirou, ele renova o token e tenta a chamada da API novamente.

2. Quais planos do Wati suportam este recurso?

Este recurso requer o plano Pro ou Business no Wati.

Integração do Chatbot com Zoho CRM

3. Como o chatbot verifica se um usuário existe no Zoho CRM?

O chatbot faz uma chamada de API para o endpoint Search Records do Zoho CRM e usa o número de telefone do usuário para pesquisar um lead existente.

4. O que acontece quando a API do Zoho CRM retorna o código de status 200?

Um código de status 200 significa que o lead existe e a resposta inclui o nome do "Lead Owner". O chatbot usa o Set a Condition para verificar se o "Lead Owner" corresponde a um nome de agente no Wati. Se houver correspondência, o nó Assign Agent atribui o chat a esse agente.

5. O que acontece quando a API do Zoho CRM retorna o código de status 204?

Um código de status 204 significa que não existe nenhum lead para o número de telefone do usuário. O chatbot trata o usuário como um novo lead e prossegue com o fluxo padrão do chatbot, incluindo o envio de uma mensagem de boas-vindas.

6. O que acontece quando a API do Zoho CRM retorna o código de status 401?

Um código de status 401 significa que o token de acesso ao Zoho CRM expirou. O chatbot usa o Endpoint de Atualização de Token de Acesso para obter um novo token, atualiza o token nos Atributos Personalizados e tenta novamente a chamada de API do Zoho CRM com o novo token.

Configuração do Token de Acesso

7. Como gero um token de acesso do Zoho CRM para o chatbot?

Acesse o console da API do Zoho em api-console.zoho.com e crie um "Self Client" para obter o client_id, client_secret e code. Em seguida, use o endpoint de token OAuth do Zoho com grant_type=authorization_code, o ID do cliente, o segredo do cliente e o código para gerar um token de acesso.

8. Onde adiciono o token de acesso do Zoho CRM no chatbot?

No primeiro nó de webhook, atualize o endpoint da API do Zoho e adicione o token de acesso. No segundo nó de webhook, vá para Customize Headers e adicione o token de acesso do Zoho CRM no campo Authorization.

9. Como o chatbot atualiza e armazena um token de acesso do Zoho CRM expirado?

Quando a API do Zoho CRM retorna o código de status 401, o chatbot usa outro nó de webhook para atualizar o token usando client_id, client_secret e refresh_token. O novo token é salvo em um contato fictício no Wati, como 22222222, e é usado para futuras execuções do chatbot.

Atribua chats automaticamente no Wati com base no Lead Owner (Proprietário do Lead) no Zoho CRM