Cómo conectar tus aplicaciones a la API de WhatsApp Business
Contenido
Conectar tus aplicaciones, CRM o plataforma e-commerce a la API de WhatsApp Business te permite enviar y recibir mensajes WhatsApp desde tus propios sistemas: notificaciones de pedidos, respuestas de soporte y campañas en un solo lugar. Con Spoki tienes un camino sencillo al acceso API, webhooks y gestión de plantillas para que tu integración sea conforme y escalable.
Esta guía explica cómo conectar tus aplicaciones a la API de WhatsApp Business, qué necesitas (cuenta, plantillas, webhooks) y cómo Spoki te ayuda. Encontrarás enlaces a registro, precios, soporte y la calculadora ROI.
Qué necesitas antes de conectar
Checklist:
- Acceso a la API de WhatsApp Business (ej. vía Spoki). Necesitas un negocio verificado y un número de teléfono para WhatsApp.
- Plantillas aprobadas para mensajes salientes fuera de la sesión de 24 horas. Spoki te guía en la creación y aprobación de plantillas.
- Opt-in: envía mensajes solo a usuarios que han aceptado recibir WhatsApp. Guarda el consentimiento en tu CRM o Spoki. Ver registro y soporte para flujos de consentimiento.
- Una aplicación o sistema que pueda enviar peticiones HTTP (ej. REST API) o recibir webhooks. La mayoría de CRMs, plataformas e-commerce y apps custom lo soportan.
Spoki proporciona la capa API y los endpoints webhook para que puedas conectar tus herramientas sin construir todo desde cero. Consulta precios y reservar para tu caso de uso.
Cómo funcionan juntos la API de WhatsApp Business y Spoki
La API de WhatsApp Business tiene dos formas principales de que tus aplicaciones interactúen:
Spoki se sitúa entre tus aplicaciones y la API de WhatsApp Business: conectas tu CRM, e-commerce o código custom a Spoki, y Spoki gestiona plantillas, sesiones y opt-in para que sigas conforme. Usa registro para empezar y soporte para la integración.
Paso a paso: conectar tu aplicación con Spoki
1. Crea tu cuenta Spoki y conecta WhatsApp
Completa el registro y vincula tu número WhatsApp Business. Spoki te guía en la verificación del negocio y el envío de plantillas para que puedas enviar mensajes aprobados.
2. Obtén credenciales API y URL de webhook
Desde Spoki obtienes credenciales API (o configuración webhook) para enviar mensajes y recibir eventos entrantes. Tu aplicación llamará a Spoki para enviar plantillas o mensajes de sesión, y Spoki puede reenviar los mensajes entrantes a tu URL webhook para que tu aplicación reaccione (ej. registrar en CRM, responder automáticamente).
3. Implementa envío y recepción en tu aplicación
- Envío: Cuando tu aplicación deba enviar un mensaje WhatsApp (ej. pedido confirmado, respuesta soporte), llama a la API de Spoki con el nombre de la plantilla y los parámetros o el contenido del mensaje de sesión. Spoki gestiona la entrega y las reglas de 24 horas.
- Recepción: Configura el webhook en Spoki para que los mensajes entrantes se envíen a tu aplicación. Tu aplicación interpreta el evento, actualiza tu base de datos o CRM y puede disparar una respuesta vía Spoki dentro de la ventana de sesión. Ver reservar y soporte para ejemplos.
4. Respeta opt-in y plantillas
Envía solo a usuarios que han dado opt-in. Para el primer mensaje o tras 24 horas de inactividad usa solo plantillas aprobadas. Spoki te ayuda a gestionar opt-in y plantillas para que la integración de tu aplicación cumpla las políticas de WhatsApp. La calculadora ROI ayuda a estimar volumen y coste.
Casos de uso habituales: CRM, E-commerce, Soporte
- CRM: Tu CRM envía a Spoki una petición cuando un lead hace opt-in o cuando quieres enviar una campaña plantilla. Los mensajes entrantes llegan a tu CRM vía webhook para que los agentes vean el hilo completo. Spoki y tu CRM mantienen opt-in y lógica de sesión sincronizados. Enlaces: registro, precios.
- E-commerce: Confirmación de pedido, actualización de envío o seguimiento de soporte: tu plataforma e-commerce llama a Spoki para enviar plantillas o mensajes de sesión. Los mensajes entrantes (ej. “¿Dónde está mi pedido?”) llegan a tu webhook; tu aplicación puede responder vía Spoki en 24 horas. Usa soporte y reservar para ayuda de diseño.
- Soporte: Los mensajes WhatsApp entrantes se entregan a tu aplicación vía webhook. Tu aplicación puede asignar el chat a un agente, mostrar historial del CRM y enviar respuestas a través de Spoki mientras la sesión esté activa. Tras 24 horas el siguiente mensaje saliente debe ser plantilla. Spoki mantiene esto claro para que tu aplicación no incumpla las reglas.
Errores a evitar
- Enviar sin opt-in: Tu aplicación solo debe enviar a usuarios que han consentido. Spoki ayuda a almacenar y comprobar opt-in para que la lógica API o webhook sea conforme.
- Usar texto libre en el primer mensaje o tras 24 h: La API exige plantillas aprobadas en esos casos. Tu aplicación debe llamar a Spoki con el nombre de plantilla y los parámetros correctos; Spoki hace el resto.
- Ignorar la seguridad del webhook: Valida las peticiones webhook (ej. firma o token) para que solo Spoki pueda enviar a tu aplicación. Spoki y soporte pueden guiarte.
- No gestionar opt-out: Cuando un usuario envía STOP, tu aplicación debe procesarlo (ej. actualizar CRM, dejar de enviar). Spoki puede reenviar los eventos opt-out a tu webhook para que tu aplicación sea conforme. Ver precios y registro para escalar.
Conclusión
Conectar tus aplicaciones a la API de WhatsApp Business con Spoki te da una única capa API y webhook para plantillas, mensajes de sesión y opt-in. Tu CRM, e-commerce o aplicación custom puede enviar y recibir WhatsApp mientras Spoki te mantiene en las reglas.
¿Listo para conectar tus aplicaciones? Visita Spoki para la API de WhatsApp Business, registro y precios. Usa la calculadora ROI para planificar tu integración y soporte o reservar para ayuda técnica.
