Webhooks

Webhooks let Aeternitychat push real-time event data to your external systems. When something happens (like a new message or contact), Aeternitychat sends an HTTP POST request to your configured URL.

Accessing Webhooks

Go to Settings > Developer > Webhooks.

Creating a Webhook

Click Add Webhook
Configure the webhook:

Field	Description
Channel	Which channel this webhook listens to — WhatsApp or Generic
URL	Your endpoint URL that will receive the events
Method	HTTP method — POST (recommended) or GET
Active	Toggle switch to enable/disable the webhook
Events	Select which event types trigger this webhook
Headers	Optional custom HTTP headers (JSON format) for authentication

Save all webhooks

You can add multiple webhooks, each listening for different events or posting to different endpoints.

Event Types

Webhook events are grouped by channel:

WhatsApp Events

message_received — A customer sent a message
message_sent — A message was sent to a customer
contact_status_changed — A contact’s status was updated

Generic Events

Fallback events that apply across all channels

Webhook Payload

Each webhook delivery includes a JSON payload with:

Event type identifier
Timestamp
Event-specific data (message content, contact details, etc.)

Your server should return a 200 status code to confirm receipt.

Troubleshooting

Issue	Solution
Webhook not firing	Verify the endpoint URL is correct and accessible
Receiving errors	Check that your server returns a 200 status code
Missing events	Confirm the event type is selected in the webhook configuration

Webhooks require the Developer permission. If you can’t access this page, ask your administrator to check your role.