Webhook key points

Before you start configuring your first webhook/ callback URL, you must know some key points about it.

Webhook key points

• The webhook should return HTTP_SUCCESS (code: 2xx) with an empty response.

📘

Failing to do so within 10 seconds, our platform will consider that the notification has failed and attempt again after a brief interval.

• Your webhook should process inbound messages & events asynchronously but acknowledge its reception synchronously & instantly.

📘

The optimal acknowledgment time is less than 100 milliseconds; nevertheless, we recognize that network delays might occur, hence 500-1000 milliseconds is the recommended acknowledgment time. The longer your response time, the more inbound messages and events will be delayed each time.

• The webhook should accept the HTTP header: User-Agent.
• The webhook should accept user events: sandbox-start.
• The webhook should have public access.

🚧

You can whitelist Gupshup's inbound request IPs as a security measure. Not only it will keep it private but also eradicate security vulnerabilities.

Drop an [email] (mailto:[email protected]) to our support team to get these IPs.