Conectar WhatsApp y Zoho CRM no consiste en copiar mensajes. El objetivo es que cada conversación actualice una oportunidad identificable, con propietario, contexto y siguiente acción.
La documentación oficial de Zoho describe una integración nativa para enviar y recibir mensajes y registrar interacciones. Antes de elegirla o complementarla, define qué debe ser fuente de verdad.
Requisitos básicos
Zoho enumera:
- Cuenta de Facebook Business Manager.
- Empresa verificada.
- Cuenta de WhatsApp Business.
- Número registrado para WhatsApp Business API.
- Edición compatible y permisos de administrador.
Verifica requisitos vigentes en la documentación: Meta y Zoho pueden actualizar el proceso.
Tres arquitecturas posibles
| Arquitectura | Ventaja | Límite |
|---|---|---|
| Integración nativa Zoho–WhatsApp | Menos componentes | Personalización condicionada por Zoho |
| Plataforma intermedia | IA, inbox y lógica adicional | Nueva capa que debe auditarse |
| Integración propia por API | Control máximo | Desarrollo y mantenimiento mayores |
Una plataforma como Sendiak puede actuar como capa conversacional y sincronizar datos con Zoho, mientras Zoho conserva leads, contactos y oportunidades.
Modelo de datos mínimo
| Zoho CRM | Regla | |
|---|---|---|
| Teléfono normalizado | Lead/Contact Phone | Formato E.164 |
| Nombre declarado | Full Name | No sobrescribir sin criterio |
| Intención | Lead Source / campo propio | Taxonomía controlada |
| Producto | Interest | Valor permitido |
| Resumen | Notes | Fecha y origen |
| Próxima acción | Task/Event | Responsable y vencimiento |
| Consentimiento | Campo propio | Evidencia y categoría |
El problema de los duplicados
Un mismo número puede aparecer con prefijos, espacios o formatos nacionales. Normaliza a E.164 antes de buscar. Después aplica una operación de upsert: actualizar si existe y crear si no.
No uses solo nombre o correo como clave. Define también qué ocurre cuando un teléfono pertenece a una empresa, una familia o un número compartido.
Flujo recomendado
- WhatsApp recibe el mensaje.
- El sistema normaliza el teléfono.
- Consulta Zoho por la clave acordada.
- Recupera propietario, etapa y contexto permitido.
- La IA responde usando conocimiento y datos autorizados.
- Guarda intención, resumen y evento.
- Si hay oportunidad, crea tarea o cita.
- Si transfiere, notifica al responsable con contexto.
Plantillas y ventana de atención
Zoho recuerda que una empresa no puede iniciar cualquier mensaje libre: fuera del contexto permitido se utilizan plantillas aprobadas. La política oficial de WhatsApp también exige consentimiento y distingue la ventana de atención.
| Situación | Acción |
|---|---|
| Cliente acaba de escribir | Responder dentro de la ventana aplicable |
| Seguimiento posterior | Usar plantilla aprobada cuando corresponda |
| Cliente pidió baja | Bloquear futuros envíos |
| Handoff | Transferir con historial y resumen |
Sincronización bidireccional
La integración madura no solo escribe en Zoho. También refleja cambios del CRM: oportunidad cerrada, propietario nuevo, cita modificada o consentimiento revocado.
Define precedencia por campo. Si un asesor cambia la etapa en Zoho, la IA no debería revertirla por una clasificación anterior.
Seguridad
- Limita permisos del token de integración.
- No envíes al modelo campos innecesarios.
- Separa organizaciones y ambientes.
- Registra acciones de escritura.
- Protege webhooks con firma o secreto.
- Implementa idempotencia para no duplicar eventos.
Pruebas antes de producción
| Caso | Resultado esperado |
|---|---|
| Número nuevo | Crea un único lead |
| Número existente | Actualiza sin duplicar |
| Webhook repetido | No duplica nota ni tarea |
| Cambio de propietario | Notifica al usuario correcto |
| API caída | Conserva evento y reintenta con límite |
| Baja | Impide campañas posteriores |
Conclusión
Una integración útil convierte chats en continuidad comercial. Normaliza identidades, define fuentes de verdad, sincroniza en ambas direcciones y diseña fallas seguras.
Revisa el caso de ventas B2B por WhatsApp y la propuesta de integración de Sendiak.
