Ir al contenido principal

Cómo solucionar problemas de integración de Wati - Zoho

Actualizado hace más de una semana

Resumen

¿Tienes problemas para enviar mensajes de WhatsApp desde Zoho CRM? Esta guía ayuda a resolver errores comunes de configuración de API, como la configuración incorrecta de puntos finales, problemas con tokens y errores en los scripts. Sigue estos pasos para que tu integración funcione sin problemas.

Instrucciones

Problemas comunes y soluciones

1. Punto final de API o token incorrecto

Síntomas: Los mensajes no se envían y aparecen errores de autenticación.

Cómo solucionarlo:

  • En Zoho CRM, ve a ConfiguraciónMarketplaceAplicaciones instaladasPlugin de Wati.

  • Actualiza estos campos:

    • URL del punto final de API: Obtén esta información de la sección API Docs de tu cuenta de Wati

    • Token Bearer: Copia de Configuración de API de Wati

  • Haz clic en Guardar.

2. Errores de configuración de funciones de flujo de trabajo

Para plantillas de un solo parámetro:

headerValue = Map();
headerValue.put("Authorization", "Bearer your_token_here"); // Reemplaza con el token realraw_data = {
    "template_name": template_name,
    "broadcast_name": "zoho_auto_" + template_name,
    "parameters": [
        {
            "name": "name",
            "value": name
        }
    ]
}; // Formato JSON válido// Formatear número de teléfono (eliminar espacios/caracteres especiales)
number = number.replaceAll("[\\s+()\\-]", "");// Invocar 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últiples parámetros:

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

Correcciones clave:

  • Reemplaza ##{{your-bearer-token}} y ##{{your-wati-api-endpoint}} con valores reales

  • Actualiza el código de país en la URL (reemplaza 91 si es necesario)

  • Asegúrate de que los parámetros estén separados correctamente por comas

3. Mapeo de campos incorrecto

Síntomas: Los mensajes se envían pero contienen datos incorrectos.

Verifica:

  • Asegúrate de que todos los campos en tu script coincidan exactamente con los nombres de los campos de Zoho CRM

  • Para contactos/clientes potenciales:

    • Los campos de teléfono deben incluir el código de país

    • Los campos personalizados necesitan nombres de API exactos

Preguntas frecuentes (FAQ)

Preguntas generales

1. ¿Cuál es el propósito de esta guía?

Esta guía te ayuda a solucionar y corregir problemas comunes al enviar mensajes de WhatsApp desde Zoho CRM usando la integración de Wati.

2. ¿Cuáles son los problemas más comunes con la integración de Zoho CRM y Wati?

Los problemas más comunes son:

  • Configuración incorrecta del punto final de API o token

  • Errores en la configuración de la función de flujo de trabajo

  • Mapeo de campos incorrecto en Zoho CRM

Configuración de API

3. ¿Cómo soluciono un punto final de API o token incorrecto en Zoho CRM?

Ve a Zoho CRM → Configuración → Marketplace → Aplicaciones instaladas → Plugin de Wati. Actualiza la URL del punto final de API y el token Bearer con los valores de tu cuenta de Wati. Haz clic en Guardar.

4. ¿Dónde puedo encontrar mi punto final de API y token Bearer en Wati?

Puedes encontrar estos detalles en tu cuenta de Wati:

  • URL del punto final de API: Disponible en la sección API Docs

  • Token Bearer: Disponible en Configuración de API

Consulta la guía "Cómo encontrar tu punto final de API y token Bearer en Wati" para obtener instrucciones paso a paso.

Configuración de función de flujo de trabajo

5. ¿Qué debo verificar si mi función de flujo de trabajo no funciona?

Asegúrate de que:

  • El encabezado de Autorización incluya tu token Bearer correcto

  • La URL de la API incluya el punto final y el código de país correctos

  • Los números de teléfono estén correctamente formateados (sin espacios ni caracteres especiales)

  • Los parámetros estén correctamente estructurados, especialmente para múltiples parámetros

6. ¿Cómo formateo correctamente los números de teléfono en el script?

Usa la siguiente línea en tu script para eliminar espacios y caracteres especiales:number = number.replaceAll("[\\s+()-]","");También, asegúrate de que el código de país (como 91 para India) esté correctamente incluido en la URL de la API.

7. ¿Cómo envío múltiples parámetros en la función de flujo de trabajo?

Usa la siguiente estructura:

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

Asegúrate de que las comas separen cada parámetro correctamente.

Mapeo de campos

8. ¿Qué debo hacer si los mensajes se envían pero muestran datos incorrectos?

Verifica que:

  • Los nombres de los campos en tu script coincidan exactamente con los nombres de los campos en Zoho CRM

  • Los campos de teléfono incluyan el código de país correcto

  • Los campos personalizados usen sus nombres de API exactos de Zoho CRM

9. ¿Dónde puedo aprender más sobre la configuración de funciones y parámetros?

Puedes encontrar instrucciones detalladas en el artículo de ayuda vinculado en la guía para comprender funciones, parámetros y mapeos de campos.

¿Ha quedado contestada tu pregunta?