Overview
This guide walks you through the complete process step by step. Whether you're building your first integration or scaling an existing system, SocialHook makes it straightforward to connect Meta messaging platforms to your infrastructure.
Getting Started
The first thing you'll need is a SocialHook account. Once connected, you'll have access to real-time webhook delivery for Facebook, Instagram, and WhatsApp — all from a single dashboard.
Key Concepts
Understanding how SocialHook routes messages is essential before building. Every inbound message from any connected platform is normalized into a consistent JSON structure and delivered to your webhook endpoint within 50ms.
The payload always includes platform, event, timestamp, and the message content. Sender information varies by platform but is always included.
Implementation
Your server needs to respond with a 200 status code within 10 seconds. If it doesn't, SocialHook will retry the delivery up to 3 times with exponential backoff (5s, 25s, 125s). All delivery attempts are logged in your dashboard.
Security
Always verify the X-SocialHook-Signature header before processing any payload. This HMAC-SHA256 signature ensures the request came from SocialHook and hasn't been tampered with.
Going Live
Once you've tested your webhook integration in a staging environment, update your production SocialHook configuration with your live endpoint URL. Monitor the delivery logs for the first few hours to ensure everything is flowing correctly.