This guide explains how to configure webhooks in SentSays, allowing you to receive real-time updates when specific events occur in your WhatsApp automation environment.

Webhooks are configured from within your SentSays dashboard. Access is granted based on your plan’s webhook feature eligibility.

​
Step 1: Access Webhook Settings

  1. Log in to your SentSays account
  2. Go to Developer Tools in the sidebar
  3. Scroll to the Webhooks section
  4. If you have webhook access (based on your plan), you will see the Add Webhook button

If you do not see the Webhooks section, your plan likely does not include webhook access. Contact support or check your current plan to upgrade.

​
Step 2: Create a New Webhook

Click on Add Webhook and fill in the following fields:

  • Webhook URL: The publicly accessible endpoint on your server that will receive the webhook data. Must be HTTPS.
  • Event Types: Select one or more events to subscribe to (e.g., message.received, contact.updated).

Click Save to activate the webhook.

​
Step 3: Test Your Webhook

Once your webhook is saved:

  • Trigger an event (e.g., send or receive a message in your account)
  • Your webhook URL will receive a POST request with the event data
  • Monitor logs on your server or use tools like Webhook.site or RequestBin for testing

​
Best Practices

  • Use HTTPS URLs to protect your data in transit
  • Always return a 200 OK response as quickly as possible
  • Log incoming events for debugging and recovery
  • Use queue-based processing if your endpoint performs heavy tasks

​
What Happens on Failure?

If your webhook endpoint fails to respond with a 2xx HTTP status code, SentSays will retry the delivery a few times with short delays between attempts.

Proper setup ensures your systems respond instantly to changes inside SentSays, enabling smooth automation and deep integration across your tools.