Integración de CRM
Integrar WhatsApp con Salesforce
La integración entre WhatsApp y Salesforce conecta el CRM de tu operación con ZapZap API, una API de WhatsApp no oficial basada en instancias. En lugar de depender del envío manual, Salesforce empieza a llamar a ZapZap API automáticamente cuando un registro cambia de estado, enviando mensajes de WhatsApp desde los propios objetos estándar (Lead, Contact, Opportunity) o desde objetos personalizados. La comunicación se hace mediante una solicitud HTTP autenticada con los encabezados x-api-key y x-api-secret, sobre la base https://api.zapzapapi.com. Cada número activo cuesta R$15 al mes con modelo prepago, y la cuenta empieza con un crédito de bienvenida (sujeto a la campaña vigente) para que pruebes el flujo de punta a punta antes de escalar.
Por qué conectar
El uso más común es reaccionar a eventos del embudo comercial. Cuando entra un Lead con un origen específico, un Flow disparado por registro llama a ZapZap API y envía el mensaje de bienvenida al WhatsApp del contacto en segundos, sin depender de que el SDR esté en línea. Cuando una Opportunity pasa a la etapa de propuesta enviada, un Outbound Message (o un HTTP Callout dentro del Flow) activa un webhook que notifica al cliente y al vendedor por WhatsApp. El mismo patrón cubre recordatorios de reuniones agendadas, seguimiento de la firma de contratos, reactivación de oportunidades detenidas y alertas internas para el equipo cuando un deal de alto valor avanza. Así Salesforce sigue siendo la fuente de verdad, y WhatsApp se convierte en el canal de ejecución automática.
Paso a paso
- 1
Crea la instancia y obtén las credenciales
En el panel de ZapZap API, aprovisiona un número, conecta WhatsApp leyendo el QR Code y copia el instanceId, la x-api-key y el x-api-secret. Estos datos autenticarán las llamadas que vengan de Salesforce.
- 2
Registra la Named Credential en Salesforce
En Setup, busca Named Credentials (Configuración > Seguridad > Credenciales con nombre). Crea una External Credential con los encabezados x-api-key y x-api-secret como Custom Headers y una Named Credential que apunte a https://api.zapzapapi.com. Esto evita exponer las claves dentro del Flow.
- 3
Arma el Record-Triggered Flow
En Setup > Automatización de procesos > Flows, haz clic en New Flow y elige Record-Triggered Flow. Selecciona el objeto (Lead u Opportunity), define el disparador como A record is created or updated y añade la condición de entrada, por ejemplo Stage igual a Propuesta Enviada.
- 4
Añade la acción de HTTP Callout
Dentro del Flow, añade un elemento Action del tipo HTTP Callout usando la Named Credential creada. Configura el método POST hacia el endpoint de envío de ZapZap API y arma el cuerpo con el número del contacto y el texto, haciendo referencia a campos del registro como {!$Record.Phone}.
- 5
Activa, prueba y monitorea
Haz clic en Activate en el Flow, crea o edita un registro real que cumpla la condición y confirma la entrega en WhatsApp. Sigue las ejecuciones en Setup > Paused and Failed Flow Interviews y ajusta los encabezados o el mapeo de campos si algún envío falla.
Ejemplo
// Ejemplo ILUSTRATIVO del cuerpo enviado por el HTTP Callout de Salesforce.
// Confirma los endpoints y campos exactos en https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
x-api-key: TU_API_KEY
x-api-secret: TU_API_SECRET
Content-Type: application/json
Body:
{
"number": "5511999999999",
"text": "¡Hola! Tu propuesta fue enviada. Si tienes alguna duda, solo responde por aquí."
}Ilustrativo. Los campos y endpoints exactos están en la documentación.
Preguntas frecuentes
¿Necesito la API oficial de WhatsApp para integrar con Salesforce?
No. ZapZap API es una API de WhatsApp no oficial basada en instancias. Conectas un número leyendo el QR Code y Salesforce empieza a enviar mensajes mediante una solicitud HTTP, sin necesidad de aprobación de plantillas ni de un proceso de cuenta oficial.
¿Debo usar Flow u Outbound Message para llamar a ZapZap API?
El Flow con HTTP Callout es el camino más directo, porque llama a ZapZap API sin intermediarios y es el enfoque que Salesforce recomienda hoy. El Outbound Message funciona cuando ya tienes un middleware o un endpoint propio que recibe el webhook de Salesforce y luego lo pasa a ZapZap API. Process Builder aún existe en orgs antiguas, pero Salesforce recomienda migrar a Flow.
¿Cuánto cuesta mantener esta integración funcionando?
El costo es de R$15 por número activo al mes, con modelo prepago. Mantienes saldo en la cuenta y cada número consume de ese saldo. La cuenta nueva recibe un crédito de bienvenida (sujeto a la campaña vigente), así que puedes validar el Flow de envío en Salesforce antes de invertir.
¿Cómo se autentica Salesforce en ZapZap API sin exponer las claves en el Flow?
Usa Named Credentials. Guardas la x-api-key y el x-api-secret en una External Credential como encabezados personalizados y haces referencia a la Named Credential en el HTTP Callout. Las claves quedan protegidas en la capa de configuración y no aparecen en el diseño del Flow.
¿Dónde encuentro los endpoints y campos exactos para armar el cuerpo de la solicitud?
Consulta https://api.zapzapapi.com/llms.txt, que es la fuente de verdad de la API. El ejemplo de código mostrado aquí es ilustrativo. Confirma siempre la ruta del endpoint y los nombres de los campos en la documentación antes de publicar el Flow en producción.
Empieza ahora
Crea tu cuenta, conecta un número en minutos y prueba la API con calentamiento y anti-bloqueo. R$15 por número activo/mes, prepago, sin permanencia.