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 Propietario de Lead correcto. Si el usuario es nuevo, puedes enviarles un mensaje de bienvenida en su lugar. Esta configuración ayuda a garantizar respuestas más rápidas y una mejor experiencia para el 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 haga lo siguiente 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:
Recupera el Propietario de Lead de Zoho.
Asigna el chat a ese Propietario de Lead en Wati.
Si el usuario no existe:
Envía un mensaje de bienvenida.
Si el token de la API de Zoho ha expirado:
Actualiza 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 inicie una nueva conversación.
2. Verificar el token de acceso almacenado
El sistema verifica si un token de acceso (necesario para las llamadas a la API) ya está guardado en los Atributos personalizados del contacto.
Si el token existe → Úsalo en el Paso 3 (Llamada a la API).
Si no → Procede a obtener un nuevo token (explicado más adelante).
3. Buscar Lead en Zoho CRM
Realiza una llamada a la API al punto final "Search Records" de Zoho CRM.
Pasa el número de teléfono del usuario para verificar si es un lead existente.
4. Manejar las 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 Propietario del Lead. | Usa "Establecer una condición" + "Asignar agente" para enviar el chat al Propietario del Lead. |
204 (Sin contenido) | No existe un lead para este número de teléfono (usuario nuevo). | Trátalos como un nuevo lead y procede con el flujo predeterminado de tu chatbot. |
401 (No autorizado) | El token de acceso ha expirado. |
|
Usa el Punto final de actualización de token de acceso para obtener un nuevo token.
Actualiza el nuevo token en Atributos personalizados.
Vuelve a intentar el Paso 3 (Llamada a la API) con el token fresco.
Pasos para configurar esto
1. Descargar la plantilla del chatbot
Descarga la plantilla del chatbot lista para usar: Check Zoho Lead Owner and Assign Chat.json
Esta plantilla contiene los flujos necesarios para conectar Wati con Zoho CRM.
2. Importar la plantilla en 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 detalles de la API de Zoho
En el primer nodo de webhook de tu flujo de chatbot:
Actualiza tu Punto final de la API de Zoho.
Agrega 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, salta al Paso 5.
Para generar un nuevo token de acceso:
Ve al Consola de API de Zoho: api-console.zoho.com
Crea un Cliente propio para obtener tu:
client_idclient_secretcode
Usa el siguiente comando para generar tu token de acceso:
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=<Ingresar ID del cliente>' \ --data-urlencode 'client_secret=<Ingresar Secreto del cliente>' \ --data-urlencode 'code=<Ingresar Código>'
Tu token se verá así:Zoho-oauthtoken 1000.xxxxxxxxxxx.xxxxxxxxxxxx
5. Agregar el token de acceso al segundo nodo de webhook
En el segundo nodo de webhook:
Ve a Personalizar encabezados.
Agrega tu token de acceso de Zoho CRM en el campo Autorización.
6. Comprender 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: El usuario existe en Zoho (Código de estado: 200)
La API devolverá el Propietario del Lead.
Usa el nodo Establecer una condición para verificar si el Propietario del Lead 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: El 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.
Realiza una llamada a la API con tu
client_id,client_secretyrefresh_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=<Ingresar ID del cliente>' \ --data-urlencode 'client_secret=<Ingresar Secreto del cliente>' \ --data-urlencode 'refresh_token=<Ingresar Token de actualización>'
Guarda el nuevo token en un contacto ficticio (por ejemplo,
22222222) en Wati.El chatbot usará este token para futuras ejecuciones.
Notas finales
Esta configuración te ayuda a:
Asignar automáticamente los chats al propietario de ventas correcto.
Proporcionar una mejor experiencia al cliente con respuestas más rápidas.
Manejar a los nuevos usuarios sin problemas con un mensaje de bienvenida.
Mantener la gestión de tokens de Zoho automatizada.
Preguntas frecuentes (FAQ)
Preguntas generales
1. ¿Cuál es el propósito de esta configuración de chatbot en Wati?
La configuración del chatbot ayuda a asignar automáticamente los chats entrantes al Propietario de Lead correcto de 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é sucede si el usuario ya está en Zoho CRM?
El chatbot recupera el Propietario de Lead asociado con el usuario y asigna el chat a ese propietario de ventas en Wati.
4. ¿Qué sucede 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 implementación
5. ¿Dónde puedo obtener la plantilla del chatbot para esta configuración?
Puedes descargar la plantilla del chatbot lista para usar Check Zoho Lead Owner and Assign Chat.json proporcionada en la guía.
6. ¿Cómo importo la plantilla del chatbot en 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 agregar tu Punto final de la 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.zoho.com), crea un Cliente propio 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 agregar el token de acceso de Zoho CRM en el chatbot?
Agrega tu Token de acceso en el campo Autorización del segundo nodo de webhook personalizando los encabezados.
Gestión de tokens
10. ¿Qué sucede si el token de acceso de Zoho CRM expira?
El chatbot detecta el código de estado 401 No autorizado y usa la API de actualización de token de Zoho para generar un nuevo Token de acceso automáticamente.
11. ¿Dónde se guarda el nuevo token de acceso después de actualizarlo?
El nuevo token se guarda en un contacto ficticio (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 del Propietario del Lead de Zoho CRM, el chatbot verifica si coincide con el nombre de un agente en Wati. Si coincide, el chat se asigna a ese agente.
13. ¿Qué sucede 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 predeterminado.
Solución de problemas
14. ¿Qué debo hacer si el chatbot no asigna los chats correctamente?
Verifica que:
El Token de acceso esté agregado correctamente.
El formato del número de teléfono en Zoho coincida con el que proporcionan los usuarios.
El nombre del Propietario del Lead 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 a los leads existentes en Zoho.
Asigna el chat al agente correcto.
Envía un mensaje de bienvenida a los nuevos usuarios.
Actualiza el token automáticamente si ha expirado.