Resumo

Tendo dificuldades para enviar mensagens do WhatsApp a partir do Zoho CRM? Este guia ajuda a resolver erros comuns de configuração da API, incluindo configuração incorreta de endpoint, problemas com tokens e erros em scripts. Siga estas etapas para fazer sua integração funcionar perfeitamente.

Instruções

Problemas comuns e soluções

1. Endpoint ou Token da API incorretos

Sintomas: Falha ao enviar mensagens e erros de autenticação.

Como corrigir:

No Zoho CRM, vá para Configurações → Marketplace → Aplicativos instalados → Plugin Wati.
Atualize estes campos:
- URL do Endpoint da API: Obtenha esta informação na seção Documentação da API da sua conta Wati
- Token Bearer: Copie das Configurações da API do Wati

Clique em Salvar.

2. Erros de configuração da função de fluxo de trabalho

Para modelos com um único parâmetro:

headerValue = Map();
headerValue.put("Authorization", "Bearer your_token_here"); // Substitua pelo token realraw_data = {
    "template_name": template_name,
    "broadcast_name": "zoho_auto_" + template_name,
    "parameters": [
        {
            "name": "name",
            "value": name
        }
    ]
}; // Formato JSON válido// Formatar número de telefone (remover espaços/caracteres especiais)
number = number.replaceAll("[\\s+()\\-]", "");// Chamar API
resp = invokeurl
[
    url: "https://your-endpoint.wati.io/api/v1/sendTemplateMessage/91" + number + "?SourceType=ZOHO"
    type: POST
    parameters: raw_data.toText()
    headers: headerValue
    content-type: "application/json"
];info resp;

Para múltiplos parâmetros:

parameters: [
    {
        "name": "name",
        "value": name
    },
    {
        "name": "phone",
        "value": phone
    },
    {
        "name": "address",
        "value": address
    }
]

Correções principais:

Substitua ##{{your-bearer-token}} e ##{{your-wati-api-endpoint}} por valores reais
Atualize o código do país na URL (substitua 91 se necessário)
Garanta vírgulas corretas entre parâmetros

3. Mapeamento de campos incorreto

Sintomas: Mensagens enviadas, mas com dados incorretos.

Verifique:

Verifique se todos os campos no seu script correspondem exatamente aos nomes de campo do Zoho CRM
Para contatos/leads:
- Campos de telefone devem incluir o código do país
- Campos personalizados precisam dos nomes exatos da API

Perguntas frequentes (FAQs)

Perguntas gerais

1. Qual é o objetivo deste guia?

Este guia ajuda você a solucionar e corrigir problemas comuns ao enviar mensagens do WhatsApp a partir do Zoho CRM usando a integração Wati.

2. Quais são os problemas mais comuns com a integração Zoho CRM e Wati?

Os problemas mais comuns são:

Configuração incorreta de Endpoint ou Token da API
Erros na configuração da Função de Fluxo de Trabalho
Mapeamento de campos incorreto no Zoho CRM

Configuração da API

3. Como corrigir um Endpoint ou Token da API incorretos no Zoho CRM?

Vá para Zoho CRM → Configurações → Marketplace → Aplicativos instalados → Plugin Wati. Atualize a URL do Endpoint da API e o Token Bearer com os valores da sua conta Wati. Clique em Salvar.

4. Onde posso encontrar meu Endpoint da API e Token Bearer no Wati?

Você pode encontrar estas informações na sua conta Wati:

URL do Endpoint da API: Disponível na seção Documentação da API
Token Bearer: Disponível nas Configurações da API

Consulte o guia "Como encontrar seu Endpoint da API e Token Bearer no Wati" para instruções passo a passo.

Configuração da função de fluxo de trabalho

5. O que devo verificar se minha Função de Fluxo de Trabalho não está funcionando?

Certifique-se de que:

O cabeçalho de Autorização inclui seu Token Bearer correto
A URL da API inclui o Endpoint e o código do país corretos
Os números de telefone estão formatados corretamente (sem espaços ou caracteres especiais)
Os parâmetros estão estruturados corretamente, especialmente para múltiplos parâmetros

6. Como formatar corretamente os números de telefone no script?

Use a seguinte linha no seu script para remover espaços e caracteres especiais:number = number.replaceAll("[\\s+()-]","");Também, certifique-se de que o código do país (como 91 para Índia) está incluído corretamente na URL da API.

7. Como enviar múltiplos parâmetros na Função de Fluxo de Trabalho?

Use a seguinte estrutura:

parameters: [
    {
        "name": "name",
        "value": name
    },
    {
        "name": "phone",
        "value": phone
    },
    {
        "name": "address",
        "value": address
    }
]

Garanta que as vírgulas separam cada parâmetro corretamente.

Mapeamento de campos

8. O que devo fazer se as mensagens forem enviadas, mas mostrarem dados incorretos?

Verifique se:

Os nomes dos campos no seu script correspondem exatamente aos nomes de campo no Zoho CRM
Os campos de telefone incluem o código do país correto
Os campos personalizados usam os nomes exatos da API do Zoho CRM

9. Onde posso aprender mais sobre a configuração de funções e parâmetros?

Você pode encontrar instruções detalhadas no artigo de ajuda vinculado no guia para entender funções, parâmetros e mapeamentos de campos.

Como resolver problemas de integração Wati - Zoho