Resumen

¿Quieres asignar automáticamente los chats entrantes al propietario de ventas correcto en Wati? Esta guía te muestra cómo verificar si un usuario ya existe en Zoho CRM y asignar su chat al Lead Owner correcto. Si el usuario es nuevo, puedes enviarle un mensaje de bienvenida. Esta configuración ayuda a garantizar respuestas más rápidas y una mejor experiencia del cliente.

Nota: Esta función requiere el plan Pro o Business en Wati.

Instrucciones

Visión General de la Solución

Configurarás un chatbot en Wati que realice las siguientes acciones cuando un usuario inicie una conversación:

Verifica si el usuario existe en Zoho CRM usando su número de teléfono.
Si el usuario existe:
Obtiene el Lead Owner desde Zoho.
Asigna el chat a ese Lead Owner en Wati.
Si el usuario no existe:
Envía un mensaje de bienvenida.
Si el token de la API de Zoho ha expirado:
Refresca el token y vuelve a intentarlo.

Cómo Configurar el Chatbot y Asignar Conversaciones

1. Configuración Predeterminada del Chatbot

Configura el chatbot para que se inicie automáticamente cada vez que un usuario comience una nueva conversación.

2. Verificar Token de Acceso Almacenado

El sistema verifica si un token de acceso (necesario para las llamadas API) está guardado en los Atributos Personalizados del contacto.
Si el token existe → Úsalo en Paso 3 (Llamada API).
Si no → Continúa para obtener un nuevo token (explicado más adelante).

3. Buscar Lead en Zoho CRM

Realizar una llamada API al endpoint "Buscar Registros" de Zoho CRM.
Pasa el número de teléfono del usuario para verificar si es un lead existente.

4. Manejar Respuestas de la API

Código de Estado	Qué significa	Acción a tomar
200 (Éxito)	Existe un lead, y la respuesta incluye el nombre del Lead Owner.	Usa "Establecer una Condición" + "Asignar Agente" para dirigir el chat al Lead Owner.
204 (Sin Contenido)	No existe un lead para este número de teléfono (nuevo usuario).	Trátalos como un nuevo lead y sigue con el flujo predeterminado del chatbot.
401 (No Autorizado)	El token de acceso ha expirado.	Actualiza el token de acceso antes de realizar más llamadas API.

Usa el Endpoint de Actualización de Token de Acceso para obtener un nuevo token.
Actualiza el nuevo token en Atributos Personalizados.
Vuelve a intentar Paso 3 (Llamada API) con el token nuevo.

Pasos para Configurar Esto

1. Descargar la Plantilla del Chatbot

Descarga la plantilla del chatbot lista para usar: Verificar Lead Owner de Zoho y Asignar Chat.json

Esta plantilla contiene los flujos necesarios para conectar Wati con Zoho CRM.

2. Importar la Plantilla a Wati

Ve a Automatización > Chatbots en tu cuenta de Wati.
Haz clic en Importar JSON.
Sube la plantilla del chatbot descargada.

3. Actualizar Tus Darectivas de la API de Zoho

En el primer nodo de webhook de tu flujo del chatbot:

Actualiza tu Endpoint de la API de Zoho.

Añade tu Token de Acceso.

4. Generar un Token de Acceso de Zoho CRM (Si es Necesario)

Si ya tienes un token de acceso para Zoho CRM, pasa al Paso 5.

Para generar un nuevo Token de Acceso:

Ve al Consola de API de Zoho: api-console.zoho.com
Crea un Self Client para obtener tu:
client_id
client_secret
code
Usa el siguiente comando para generar tu token de acceso:

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>'

Tu token se verá así: Zoho-oauthtoken 1000.xxxxxxxxxxx.xxxxxxxxxxxx

5. Añadir el Token de Acceso al Segundo Nodo de Webhook

En el segundo nodo de webhook:

Ve a Personalizar Encabezados.
Añade tu token de acceso de Zoho CRM en el campo Autorización.

6. Entender Cómo Funciona la Lógica del Chatbot

El chatbot usa la API de Zoho para buscar un usuario basado en su número de teléfono.

Caso 1: Usuario Existe en Zoho (Código de Estado: 200)

La API devolverá el Lead Owner.
Usa el nodo Establecer una Condición para verificar si el Lead Owner coincide con el nombre de un agente en Wati.
Si coincide, usa el nodo Asignar Agente para asignar el chat a ese agente.

Caso 2: Usuario No Existe en Zoho (Código de Estado: 204)

Trata a este usuario como nuevo.
Envía un mensaje de bienvenida.

Caso 3: Token de Acceso Expirado (Código de Estado: 401)

Usa otro nodo de webhook para actualizar el token.
Realizar una llamada API con tu client_id, client_secret, y refresh_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 Finales

Esta configuración te permite:

Asignar automáticamente chats al propietario de ventas correcto.
Proporcionar una mejor experiencia al cliente con respuestas más rápidas.
Manejar nuevos usuarios su grafiosamente con un mensaje de bienvenida.
Mantener el manejo de tu token de Zoho automatizado.

Preguntas Frencuentes (FAQs)

Preguntas Generales

1. ¿Cuál es el propósito de esta configuración del chatbot en Wati?

→ La configuración del chatbot ayuda a asignar automáticamente los chats entrantes al Lead Owner correcto desde Zoho CRM basado en el número de teléfono del usuario. Si el usuario no existe en Zoho CRM, el chatbot envía un mensaje de bienvenida.

2. ¿Qué plan de Wati se requiere para usar esta función?

→ Esta función requiere el plan Pro o Business en Wati.

3. ¿Qué pasa si el usuario ya está en Zoho CRM?

→ El chatbot obtiene al Lead Owner asociado con el usuario y asigna el chat a ese propietario de ventas en Wati.

4. ¿Qué pasa si el usuario no se encuentra en Zoho CRM?

→ El chatbot trata al usuario como nuevo y envía un mensaje de bienvenida.

Configuración e Instalación

5. ¿Dónde puedo obtener la plantilla del chatbot para esta configuración?

→ Puedes descargar la plantilla del chatbot lista para usar Verificar Lead Owner de Zoho y Asignar Chat.json proporcionada en la guía.

6. ¿Cómo importo la plantilla del chatbot a Wati?

→ Ve a Automatización > Chatbots en tu cuenta de Wati, haz clic en Importar JSON y sube la plantilla descargada.

7. ¿Qué detalles de Zoho CRM necesito configurar en el chatbot?

→ Necesitas añadir tu Endpoint de API de Zoho y Token de Acceso en los nodos de webhook relevantes del flujo del chatbot.

8. ¿Cómo genero un nuevo Token de Acceso de Zoho CRM?

→ Ve a la Consola de API de Zoho (api-console.zelho.com), crea un Self Client y usa el client_id, client_secret, y code proporcionados para generar el token de acceso usando el comando curl proporcionado.

9. ¿Dónde debo añadir el Token de Acceso de Zoho CRM en el chatbot?

→ Añade tu Token de Acceso en el campo de Autorización del segundo nodo de webhook personalizando los encabezados.

Gestión de Tokens

10. ¿Qué pasa si el Token de Acceso de Zoho CRM expira?

→ El chatbot detecta el código de estado 401 No Autorizado y usa la API Zoho Refresh Token para generar un nuevo Token de Acceso automáticamente.

11. ¿Dónde se guarda el nuevo Token de Acceso después de refrescarlo?

→ El nuevo token se guarda en un contacto dummy (por ejemplo, número de teléfono 22222222) en Wati para uso futuro.

Lógica del Chatbot

12. ¿Cómo decide el chatbot a qué agente asignar un chat?

→ Si la respuesta de la API devuelve el nombre de un Lead Owner desde Zoho CRM, el chatbot verifica si coincide con el nombre de un agente en Wati. Si coincide, el chat se asinga a ese agente.

13. ¿Qué pasa si no hay un agente coincidente en Wati?

→ Si no se encuentra un agente coincidente, puedes configurar el chatbot para seguir tu flujo predeterminado, como enviar un mensaje de bienvenida o asignar el chat a un agente por defecto.

Solución de Problemas

14. ¿Qué debo hacer si el chatbot no asigna chats correctamente?

→ Verifica que:

El Token de Acceso esté correctamente añadido.
El formato del número de teléfono en Zoho coincida con el que los usuarios proporcionan.
El nombre del Lead Owner en Zoho coincida con el nombre del agente en Wati.

15. ¿Cómo puedo probar si la configuración del chatbot funciona correctamente?

→ Puedes simular una conversación de usuario en Wati y verificar si el chatbot:

Identifica leads existentes en Zoho.
Asigna el chat al agente correcto.
Envía un mensaje de bienvenida a nuevos usuarios.
Refresca el token automáticamente si ha expirado.

Asignación Automática de Chats en Wati Según el Propietario del Cliente en Zoho CRM