Webhook Events
Last updated
Was this helpful?
Last updated
Was this helpful?
We are updating the list of IP addresses used by our webhook service. This change is part of our ongoing efforts to enhance infrastructure security and reliability.
What’s Changing:
A new set of IP addresses will be introduced for webhook traffic.
The current IP addresses will be deprecated and will stop working after June 9, 2025.
Action Required:
To ensure uninterrupted delivery of webhook events, please update your firewall or allowlist configurations to include the new IP addresses before June 9, 2025. You can find the updated list of IPs below separated by application region:
Singapore
52.77.130.167
54.251.77.74
54.255.59.189
18.142.212.217
Europe (Frankfurt)
3.127.106.141
3.65.238.41
3.65.52.7
3.77.135.138
United States (North Virginia)
52.70.191.115
100.24.154.219
52.44.28.213
52.72.76.90
Failure to update your configurations may result in webhook delivery failures after the deprecation date.
If you have any questions or need assistance, please contact our support team at support@social.plus or submit request through .
Webhook Events is a great way you can extend and build custom functionalities on your own by receiving triggers from Social Plus. When enabled, events that happen within your Chat and Social SDK are forwarded to your system in real-time. By receiving these events you can build and extend your own functions such as
Storing those events to build your own analytic dashboard
Build a custom message moderation or automatic banning system
Build custom search and personalization functionalities based on user activities forwarded to your analytic system.
A webhook can also be termed as a type of API that is driven by events rather than requests. Instead of one application making a request to another to receive a response, a webhook is a service that allows one program to send data to another as soon as a particular event takes place. Webhooks are sometimes referred to as “reverse APIs,” because communication is initiated by the application sending the data rather than the one receiving it.
To receive these events you will need to set up a Webhook system as detailed below.
When an event is triggered, an HTTP POST payload is sent to the Webhook's configured URL. Webhooks can serve various purposes such as creating push notifications, backup logging or even building external applications based on Webhook events.
Admin users can create new Webhooks in the admin panel by using the URL.
Admin users can delete selected Webhooks in the admin panel as well.
We recommend having no more than 10 Webhooks per network.
All Webhooks will be triggered near-real-time as the events occur. Please seeEvents for list of events available.
To preserve system performance, all webhook HTTP requests will timeout in 1.5 seconds - please make sure your webhook receiver responds back within the interval to prevent losing any requests.
Upon receiving the webhook, the system should return with the response status code of 200
with an empty JSON response.
The HTTP POST payloads that are delivered to your webhook's configured URL endpoint will contain the following headers:
Header
Description
x-amity-signature
the HMAC Base64 digest of the response body. The HMAC Base64 digest is generated by performing SHA-256 hash function with the secret key as the HMAC key, JSON request body as the payload and digested as Base64 string.
Please make sure you verify x-amity-signature
header by calculating HMAC Base64 signature of the payload with the secret key of your corresponding webhook endpoint before processing the event to prevent request forgery.
To maintain legacy support, you may receive 2 requests per event with another request containing x-eko-signature
- you may ignore this request.
From 20 June 2022, we have deprecated the following legacy webhook events:
message.created
channel.created
channel.joined
channel.membersAdded
v3.video-streaming.didRecord
v3.video-streaming.didStart
v3.video-streaming.didStop
The webhook feature is currently in Private Beta. Please submit your request to the to enable this feature. It will take approximately 5 business days to process your request.
Once webhook is activated, you will start receiving events on a near-real-time basis. Please check for the full list of events and their payload.
As these webhook events were only accessible internally, this deprecation should have no impact on our current customers. For a list of events that we currently support, please refer to our .