Articles on: Integrations

Webhooks v2

TimelinesAI webhooks allow to notify an external system when specific events occurs within your TimelinesAI workspace in real-time.
Multiple webhooks can be created per workspace. The default limit for the number of webhooks per workspace is set to 10. If you need to increase this limit, you can purchase a paid add-on. For more information please contact support team.

To Create Webhooks

Open Integrations from the main navigation menu > then open Webhooks v2 tab > then click + Add Endpoint button

Provide required details and click Add endpoint
Endpoint URL: a valid URL where the webhook data should be sent.
Event Type: select the event type from a dropdown menu.
Status: use the toggle switch to activate/deactivate the webhook

To Manage Created Webhooks

Open Integrations from the main navigation menu > then open Webhooks v2 tab .
Here you will see the list of all created webhooks with details and an option to edit or delete a webhook.
URL: endpoint URL where webhook data is sent
Event type: selected event type
Activations: the number of times the event was fired to your endpoint in the last 10 days. Both successful and failed attempts are included in this count.
Error rate: the % of activations that received an error in response from your endpoint. Calculated from the last 1000 activations over the past 10 days.
Last Response: response received from your endpoint for the latest fired event
Download log: txt file with the execution log of last 1000 activations. Log entries are stored for 10 days
Last edited by: the name and date of the last team member who edited the webhook
Status: whether the webhook is active or disabled.
Actions: displayed on mouse hover. Allows editing or deleting the webhook
Download webhooks change log: an audit log for all changes in webhook endpoints. Allows to see who created, edited, modified or deleted webhooks.

Event types

Message and Chat Events: all message and chat events are triggered for all WhatsApp accounts connected to the workspace, including those initiated from a mobile app or another linked device. The incoming/outgoing direction is relative to the WhatsApp account as a whole, not to any specific session (e.g., mobile app, WhatsApp Web, or TimelinesAI connection).

message:new: Triggered when there is a new sent and/or received message
message:sent:new: Triggered when a new outgoing message
message:received:new: Triggered when there is a new incoming message.
chat:new: Triggered when there is a new direct or group chat.
chat:incoming:new: Triggered when there is a new incoming direct chat.
chat:outgoing:new: Triggered when there is a new outgoing direct chat.
chat:responsible:assigned: Triggered when a chat was (re)assigned to a workspace member.
chat:responsible:unassigned: Triggered when a chat was unassigned.

Account Disconnection and Suspension Events: The whatsapp:account:disconnected event is triggered when the WhatsApp account is permanently disconnected from the workspace. The whatsapp:account:suspended event is triggered when message syncing is temporarily paused due to subscription cancellation or downgrade. It is recommended to subscribe to both events to ensure uninterrupted messaging operations.

whatsapp:account:disconnected: Triggered when WhatsApp account was disconnected.
whatsapp:account:suspended: whatsapp:account:suspended
whatsapp:account:resumed: Triggered when a WhatsApp account message syncing is resumed.

For detailed information on the events structure and format , please refer to our documentation page.


An email notification is sent to the workspace owner in case of multiple successive errors for a specific webhook endpoint.
The webhook itself will not be disabled.

Usage example how to use TimelinesAI webhooks as a trigger how to use TimelinesAI webhooks as a trigger

Updated on: 12/06/2024

Was this article helpful?

Share your feedback


Thank you!