Visión general
Esta guía te lleva paso a paso por el proceso completo. Tanto si estás construyendo tu primera integración como si estás escalando un sistema existente, SocialHook hace que conectar las plataformas de mensajería de Meta a tu infraestructura sea muy sencillo.
Primeros pasos
Lo primero que necesitarás es una cuenta de SocialHook. Una vez conectado, tendrás acceso a la entrega de webhooks en tiempo real para Facebook, Instagram y WhatsApp, todo desde un único panel.
Conceptos clave
Antes de empezar a construir es fundamental entender cómo SocialHook enruta los mensajes. Cada mensaje entrante desde cualquier plataforma conectada se normaliza en una estructura JSON consistente y se entrega a tu endpoint de webhook en menos de 50 ms.
El payload siempre incluye platform, event, timestamp y el contenido del mensaje. La información del remitente varía según la plataforma, pero siempre está incluida.
Implementación
Tu servidor debe responder con un código de estado 200 en menos de 10 segundos. Si no lo hace, SocialHook reintentará la entrega hasta 3 veces con backoff exponencial (5 s, 25 s, 125 s). Todos los intentos de entrega quedan registrados en tu panel.
Seguridad
Verifica siempre la cabecera X-SocialHook-Signature antes de procesar cualquier payload. Esta firma HMAC-SHA256 garantiza que la petición proviene de SocialHook y no ha sido manipulada.
Pasar a producción
Una vez que hayas probado tu integración de webhook en un entorno de staging, actualiza la configuración de producción de SocialHook con la URL de tu endpoint en vivo. Monitorea los logs de entrega durante las primeras horas para asegurarte de que todo fluye correctamente.