> ## Documentation Index
> Fetch the complete documentation index at: https://timelines.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# New Chat

> Triggered when there is a new direct or group chat.



## OpenAPI

````yaml webhook chat:new
openapi: 3.1.0
info:
  title: Webhook API
  description: >
    Webhooks are a way to send real-time data from one application to another
    whenever a specific event occurs. Our specific implementation sends data
    using the POST method to a specified endpoint. Authentication of the request
    or customizing headers is not supported.


    ## Key Features


    - **Multiple Webhooks per Workspace**: Create multiple webhooks within a
    single workspace, each supporting one specific event.

    - **Customizable Limits**: The default limit on the number of webhooks per
    workspace is 10. To increase this limit, a paid add-on is available. Please
    contact support for more information.

    - **Audit log**: An audit log for all changes in webhook endpoints is
    available on the Webhooks management display.

    - **Execution log**: Execution logs for each webhook can be downloaded from
    the Webhooks management page. Up to 1000 execution entries are stored for a
    maximum of 10 days.

    - **Error Notification for Webhook Endpoint Failures**: An email
    notification is sent to workspace owner in case of multiple successive
    errors for a specific webhook endpoint. However, the webhook will not be
    disabled.


    ### Note: 

    - 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 (such as a mobile app, WhatsApp Web, or
    TimelinesAI connection).

    - whatsapp:account:disconnected is triggered when the WhatsApp account is
    permanently disconnected from the workspace, while
    whatsapp:account:suspended is triggered when message syncing is temporary
    paused due to subscription cancellation or downgrade (it will not be
    triggered for disconnection).

    We recommend to subscribe for both events to ensure that messaging operation
    is not interrupted.

    - IDs of objects returned by Webhooks can be used in conjunction with
    TimelinesAI Public API and Zapier to fetch additional data or perform
    actions.
  version: 2.0.0
servers: []
security: []
paths: {}

````