Gallabox offers a Webhook feature that allows you to set up real-time integration with external systems or services. This feature enables you to send data and notifications from Gallabox to other platforms, ensuring seamless communication and automation. Here is the key components in Webhook configuration:
  1. 1.
    Request URL: The Request URL is the endpoint where Gallabox sends data and events. This is typically an external system or service that can receive HTTP requests. You specify the URL of the receiving system here.

Add New Webhook

Go to Settings in the left navigation panel and select Webhook. Click on + Add new.

Add Details of Webhook

Add the Request URL, secret, headers, and select the events.
Request URL*: Enter the URL where the webhook notifications will be sent.
Secret: Optionally, enter a secret token for added security.
Headers: Optionally, customize HTTP headers for the webhook request.
Select Events*: Choose from a variety of events for which notifications will be triggered.

Webhook Events

Users can select from the following categories of events:


  1. 1.
    Contact.created: Triggered when a new contact is created.
  2. 2.
    Contact.updated: Triggered when an existing contact is updated.
  3. 3.
    Contact.mapped: Triggered when a contact is mapped to another entity.
  4. 4.
    Contact.unmapped: Triggered when a contact is unmapped from an entity.


  1. 1.
    Conversation.created: Triggered when a new conversation is initiated.
  2. 2.
    Conversation.updated: Triggered when an existing conversation is updated.
  3. 3.
    Conversation.UnAttended: Triggered when an existing conversation is unattended.
  4. 4.
    Conversation.Tag.mapped: Triggered when a tag is mapped to a conversation.
  5. 5.
    Conversation.Tag.unmapped: Triggered when a tag is unmapped from a conversation.


  1. 1.
    Message.received: Triggered when a new message is received.
  2. 2.
    Message.flow.received: Triggered when a message flow is received.
  3. 3.
    Message.WA.status.received: Triggered when the status of a WhatsApp message is received.
  4. 4.
    Message.WA.status.failed: Triggered when a WhatsApp message fails to send.


  1. 1.
    Template.status: Triggered when the status of a message template changes.

Webhook Logs

Webhook Logs provide detailed information about webhook events, their status, and associated data. Here's what you can find in the Webhook Logs in Gallabox:
1. Webhook Log ID: This is a unique identifier for each webhook log entry, enabling easy reference and tracking of webhook activities.
2. Event: The "Event" column specifies the type of event that triggered the webhook. For example, "Conversation Update" or "Message Received."
3. Created At: This timestamp indicates when the webhook event occurred, offering a chronological view of webhook activities.
4. Status: The "Status" field represents the current state of the webhook event. In this context, "Failed" indicates that the webhook event was not successful.
5. Payload: The "Payload" refers to the data associated with the webhook event. It includes the content or information transferred from Gallabox to the external system or service via the webhook.
Last modified 8d ago