Webhooks
Moderation events merit special attention. With webhooks turned on in your Sendbird application, your server will receive HTTP POST requests from Sendbird server with a payload containing details of the event whenever a moderation event occurs. You can use the webhooks to keep track of the moderation events in your application and take necessary actions based on the events.
Configuration
As Advanced moderation is part of Sendbird Chat, you can configure a webhook endpoint URL and other settings on the Settings > Chat > Features and Webhooks on the Sendbird Dashboard.
- Toggle on the Webhooks under Settings > Chat > Features first.
- Then go to Settings > Chat > Webhooks to set up your webhook endpoint URL and event types.
To learn more, see our guide on webhooks for Sendbird Chat.
Webhook events
Advanced moderation webhooks are available for all Sendbird Chat customers. Among all the events that you can receive through Sendbird Chat webhooks, the following events are related to advanced moderation features:
| Event | Invoked when |
|---|---|
A user blocks another user. | |
A user unblocks another user. | |
A user is muted in a specific channel or across the application. | |
A user is banned from a specific channel or across the application. | |
A user account is deactivated. | |
A message with explicit images or inappropriate image URLs is blocked. | |
Explicit words in a message are replaced with asterisks (*). | |
A message with explicit words is blocked. | |
A user is imposed with one of the moderation penalties among mute, kick, and ban. | |
A message with explicit words is detected without being blocked or replaced. | |
| A message triggers a custom moderation extension. |
| A message is blocked by the advanced profanity filter based on keyword group rules. |
| The advanced profanity filter detects keywords but takes no action, logging the event for auditing. |
| The advanced profanity filter replaces detected keywords in a message with placeholder characters. |