Articles on: Integrations

Webhooks v2

TimelinesAI webhooks notify external systems (that you have connected through Webhooks endpoints) about events happening in a TimelinesAI workspace in real time. You can create up to 10 webhooks per workspace at a single point in time. But if you need more webhooks, you can buy an add-on.

This documentation will explore how to set up, manage, and optimize webhooks in your TimelinesAI workspace, ensuring seamless integration with your external systems.

Add Webhook Endpoint URL

Manage Webhooks

Event Types

Let’s get started 🚀

Add Webhook Endpoint URL



By adding a webhook endpoint URL in TimelinesAI, you can connect it with other tools and systems you use. When you set up a webhook in TimelinesAI, it allows the platform to notify your specified URL whenever certain activities or changes happen in your workspace. This enables seamless communication between different tools, helping you stay updated in real-time without the need for manual checks.

In this demo, we’ll show you how to set up the webhook endpoint URL for your external system.



Manage Webhooks



Once you add your webhook endpoint, you can manage it by viewing, editing, deleting, or modifying its settings. While managing the Webhook endpoints, you can:

Edit Webhook v2 Endpoint

Delete Webhook v2 Endpoint

Activate/Deactivate a Webhook v2 Endpoint

Download Log

Editing The Webhook v2



You can update webhook settings like the endpoint URL and event type to get real-time notifications. You may further change the endpoint URL if your system's address is updated. You can also adjust the event type to choose which events send notifications, so you only receive the information you need.



Deleting a Webhook v2



You can remove unnecessary webhook endpoints when you no longer need them. It will help you to organize your workspace and prevent unwanted event triggers or outdated endpoints.

In the demonstration below, we’ll show you how to delete the webhook endpoint URL for your external system.



Activating/Deactivating a Webhook v2 Endpoint



If you have created a webhook endpoint but don’t need it at the moment, you can deactivate the endpoint. Later on, you can switch it on whenever you need the webhook endpoint. To change the active state of the endpoints, you just need to toggle the “Endpoint Activated” icon.

Activating/Deactivating a Webhook v2 Endpoint

Download Log



You can download your webhook logs to track all changes made to webhook endpoints, including details like the webhook ID, Webhook URL, Event type, Timestamp (created time), user name, user email, and new values. It indicates the specific settings associated with the webhook, such as the URL, its enabled status, and the event type that triggers it. These webhook logs contain the last 1,000 activations, with entries stored for up to 10 days. Thus, they will provide you with deeper insights into webhook activity.

Download Log

Event Types



Below are the event types that TimelinesAI currently supports: Message and Chat Events, which include all messages sent and received across all WhatsApp accounts linked to your workspace. This applies to messages from any device, whether a mobile app, WhatsApp Web, or TimelinesAI itself. The event tracks messages as a whole, not by individual device or session.



Notifications



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



Make.com: how to use TimelinesAI webhooks as a trigger
Zapier.com: how to use TimelinesAI webhooks as a trigger

Updated on: 17/01/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!