Gallabox Docs
ChangelogHow To GuidesAPI DocsStatus pageVisit our websiteFeedback
Gallabox Docs
Gallabox Docs
  • Welcome to Gallabox Docs
  • 🆕Get Started
    • Pre-requisites
    • Signup
    • Explore Demo Account
    • Activate Free Trial
  • ✅Connect WhatsApp Channel
    • Connect your WhatsApp
    • Meta Business Verification
    • Apply for WhatsApp Blue Tick
    • Migrate to Gallabox
    • Messaging Limits & Quality Ratings
    • Gallabox Account Setup FAQs
  • 🈁CONVERSATIONS
    • Gallabox Conversations Glossary
    • Team Inbox
    • Initiate a New Chat
    • Compose Box
    • Inboxes
    • Manage Inbox
    • Views
    • Efficiently using inbox
    • Gallabox Conversations FAQs
  • 📘CONTACTS
    • Gallabox Contact Glossary
    • Add Contact
    • Contact Segments
    • Contact Management
    • Contact Updation
    • Contact Deletion
    • Export Contacts
    • Marketing Opt-In
      • Marketing opt-in on contact creation
      • Marketing opt-in Handling Methods
      • Marketing opt-out Management
  • 🤖BOTS
    • Gallabox Bot Glossary
    • Things to know before building your first bot
    • Bot Essentials
    • Bot in Gallabox
      • Create a Bot using AI
      • Create a Bot using Bot Templates
      • Create a Bot from Scratch
    • Flow in the Bot
      • AI Based Flow
      • CTWA Ad Based Flow
    • Send Card
      • Send Text
      • Send Media
      • Send Collection
      • Send Products
      • Send Voice
      • Send Template
      • Send Form
      • Send Location
      • Send Payments
    • Ask Questions
      • Ask Text
      • Ask Number
      • Ask Phone
      • Ask Email
      • Ask Date
      • Ask Location
      • Ask Address
      • Ask URL
      • Ask File
      • Ask Button Option
      • Ask List Option
      • Ask Keyword Option
      • Ask Collection List
      • Ask Form
      • Ask Payments
    • Bot Utilities
      • Send Button Option
      • Send List Option
      • Delay
      • Condition
      • Set Variable
      • Jump to
      • Switch
      • AI node - GPT Dialog
      • AI node - GPT Knowledge Base
      • Working hours
      • Hint
      • Wait for order
    • Bot Actions
      • Assign Conversation
      • Unassign Conversations
      • Resolve Conversations
      • Update Conversation Fields
      • Update Contact Fields
      • Update Company Fields
      • Push to Sequence
      • Add Note & Mention
      • Conversion Events
    • Bot Connectors
      • Connect your system with the WhatsApp chat bot using API
      • Connect WhatsApp and Google Sheets to Collect Responses
      • Send payment links via WhatsApp chatbot using Razorpay integration
      • Send your WhatsApp data to Zoho CRM using Chatbot
      • Connect Shopify and WhatsApp to collect orders using chatbot
      • Send your WhatsApp data to HubSpot using Chatbot
      • Send your WhatsApp data to Zoho Bigin using Chatbot
      • Send your WhatsApp data to Leadsquared using Chatbot
      • Send your WhatsApp data to WooCommerce using Chatbot
      • Connect ChatGPT with WhatsApp in Gallabox Chatbot
      • Zoom WhatsApp Integration - How to enable webinar registration on WhatsApp
      • Send your WhatsApp data to Sangam CRM using Chatbot
      • Send payment links via WhatsApp chatbot using PhonePe
      • Send Payment links via WhatsApp Chatbot using Stripe
      • Enhance Chatbot with ElevenLabs AI Voice Synthesis
      • Send your WhatsApp data to Pipedrive CRM using Chatbot
      • Send your WhatsApp data to PetPooja using Chatbot
    • Set up Default Bot
    • Bot Management
    • Gallabox Bot FAQs
  • 🔊BROADCAST
    • Gallabox Broadcast
    • Select Template
    • Select Audience
    • Review and Send Broadcast
    • Broadcast Analytics and Report
    • Gallabox Broadcast FAQs
  • 🔢WHATSAPP DRIP CAMPAIGNS
    • Understanding Drip Marketing
    • Basics of Drip Campaign
    • Create New Drip Campaign
    • Drip Campaign Setup
    • Drip Campaign Message Management
    • Campaign Management Options
    • Drip Campaign Analytics
    • Gallabox WhatsApp Drip Marketing FAQs
  • 📈AD CAMPAIGNS
    • CTWA in Gallabox
    • Create your Campaign
    • Click To WhatsApp Analytics
    • CAPI Integration
    • Gallabox CTWA FAQs
  • 🛒WHATSAPP SHOP
    • Gallabox WhatsApp Shop Overview
    • Connect the Catalog with Meta
    • Connect Catalog with Gallabox
    • WhatsApp Order Summary
    • Gallabox WhatsApp Shop FAQs
  • 🪙PAYMENTS
    • Gallabox Native Payments Overview
    • Establish Connection
    • Sending Payment Links
    • Tracking Payments
    • Gallabox Native Payment FAQs
  • 🔃WhatsApp Forms
    • Gallabox WhatsApp Forms Overview
    • Create WhatsApp Forms
      • Create WhatsApp Forms in Gallabox
      • Create WhatsApp Forms with Template Builder
      • Create WhatsApp Forms using JSON
    • Sending a WhatsApp Form
      • Send WhatsApp Form in a Message Template
      • Send WhatsApp Form in a Bot
    • Receiving Response of WhatsApp Forms
    • Best Practices for WhatsApp Forms
    • Gallabox WhatsApp Forms FAQS
  • ℹ️WHATSAPP CHANNEL
    • Channel Settings
    • Manage your Connections
    • Widget for your website
    • Configuration Message Settings
    • WhatsApp Magic Link
    • Block List
    • User Mapping
    • Assignments Rules
    • Compliance Info
    • Account Profile Info
    • WhatsApp Channel FAQs
    • WhatsApp Business API Errors
  • 🚧INTEGRATION
    • E-commerce Platforms
      • Shopify
        • Shopify Template Variables for WhatsApp Messages
        • Workflows for Shopify
      • WooCommerce
        • Workflows for WooCommerce
      • WooCommerce Cart Abandonment Recovery
      • Shopflo
    • Customer Relationship Management (CRM) Systems
      • HubSpot
        • Workflows for HubSpot
      • Kylas
        • Workflows for Kylas
      • Zoho CRM & Signals
        • Workflows for Zoho
      • Leadsquared
        • Workflows for LeadSquared
      • Sangam
      • Pipedrive
      • Odoo
    • Shipping and Logistics
      • ShipRocket
        • Workflows for ShipRocket
      • Shipway
        • Workflows for Shipway
    • Payment Gateways
      • Cashfree
        • Workflows for Cashfree
      • Razorpay
        • Workflows for Razorpay
      • Stripe
        • Stripe Workflows
    • Marketing and Engagement Platforms
      • WebEngage
        • WebEngage WhatsApp Campaigns
      • MoEngage
      • Facebook Leads
        • Send Automated Messages on WhatsApp to Facebook Leads
        • Send Sequence of Messages to Facebook Leads
      • CleverTap
      • Fyno
    • Other Integrations
      • Generic Webhooks
      • Google Sheets
      • Pabbly
      • Zapier
      • Zoho Books
        • Zoho Books Notifications
        • Workflow for Zoho Books
      • Calendly
        • Workflows for Calendly
      • Miitel
    • Gallabox Integration FAQs
  • ⚙️ACCOUNT MANAGEMENT
    • Account Essentials
    • User Details
    • User, Teams, and Roles
    • Account Details
  • 💰Pricing & Billing Modules
    • Conversation Pricing
    • New Per-Message Pricing — Effective July 1, 2025
    • Message Credits
    • Billing & Subscriptions
    • FAQs
  • 🚾Web-Chat Channel
    • Web-Chat Channel
  • 🧰Basic Modules
    • WhatsApp Templates
      • Template Creation and Editing
      • Re-write with AI
      • Custom Marketing and Utility Templates
      • Product Marketing Templates
      • Authentication Templates
      • Limited-Time Offer Templates
      • Order Details Template
      • Coupon Code WhatsApp Template
      • Carousel Template
      • WhatsApp template URL tracking
      • FAQs - WhatsApp Template Messages
    • Contact Fields
    • Conversation Fields
    • Tags
    • Message Tracker
    • Canned Responses
  • 🔒Account Security Features
    • Allowed IPs
    • Activity Log
    • Two Factor Authentication
  • 👨‍💻DEVELOPER RESOURCES
    • API Key and Secret
    • API Docs
    • Webhook
    • Conversation Widget
  • 📊REPORTS & ANALYTICS
    • Dashboard
    • WhatsApp Failed Messages
    • WhatsApp Notification Messages
    • Conversation Report
  • Privacy and Security
    • Data Security and Infra
    • Subprocessors
    • Data Processing Agreement
  • 👾EXTRAS
    • WhatsApp Business API - Unsupported Messages
    • Understanding Message Delivery Issues on WhatsApp
    • WhatsApp’s New Per-user Messaging Limits
  • Frequently Asked Questions
Powered by GitBook
On this page
  • Add New Webhook
  • Add Details of Webhook
  • Webhook Events
  • Webhook Logs
  • Verifying requests from Gallabox
  • Whatsapp Channel webhook check
  1. DEVELOPER RESOURCES

Webhook

Enhance communication and automation with Gallabox's Webhook feature. Easily set up data and event notifications by configuring the URL, secret token, HTTP headers, & selecting specific events.

PreviousAPI Key and SecretNextConversation Widget

Last updated 1 month ago

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. 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.

Field
Description

Request URL*

Enter the URL where the webhook notifications will be sent.

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:

Contact

Event
Descrition

Contact.created

Triggered when a new contact is created.

Contact.updated

Triggered when an existing contact is updated.

Contact.mapped

Triggered when a contact is mapped to another entity.

Contact.unmapped

Triggered when a contact is unmapped from an entity.

Conversation

Event
Description

Conversation.created

Triggered when a new conversation is initiated.

Conversation.updated

Triggered when an existing conversation is updated.

Conversation.UnAttended

Triggered whenever autoReply message is being sent.

Conversation.Tag.mapped

Triggered when a tag is mapped to a conversation.

Conversation.Tag.unmapped

Triggered when a tag is unmapped from a conversation.

Message

Event
Description

Message.received

Triggered when a new message is received.

Message.flow.received

Triggered when a message flow is received.

Message.WA.Cart.received

Triggered when a cart message is received on WhatsApp

Message.WA.status.received

Triggered when the status of a WhatsApp message is received.

Message.WA.status.failed

Triggered when a WhatsApp message fails to send.

Message.WA.Payment.status.received

Triggered when the status of a payment message sent via WhatsApp is received.

Message.WA.Interaction.Received

Captures only the rteply,clicks, and reaction for the Message

Template

Event
Description

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:

Field
Description

Webhook Log ID

This is a unique identifier for each webhook log entry, enabling easy reference and tracking of webhook activities.

Event

The "Event" column specifies the type of event that triggered the webhook. For example, "Conversation Update" or "Message Received."

Created At

This timestamp indicates when the webhook event occurred, offering a chronological view of webhook activities.

Status

The "Status" field represents the current state of the webhook event. In this context, "Failed" indicates that the webhook event was not successful.

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.

Verifying requests from Gallabox

Gallabox secures its requests with a unique secret (configured by you) specific to webhooks. Using the webhook secrets, your app can more reliably confirm the authenticity of Gallabox requests.

Validating a Request

To verify the requests, follow these steps:

  1. Retrieve the signature: Extract the signature from the x-gallabox-signature header in the incoming HTTP request.

  2. Create a hash: Generate an HMAC SHA-256 hash using your webhook secret and the request payload.

  3. Compare with the signature: Compare the generated hash with the signature from the HTTP header.

If the hash and the signature match, the request is verified as originating from Gallabox and can be processed. If not, the request should be rejected.

For enhanced security, keep the secrets confidential and update regularly.

Whatsapp Channel webhook check

In WhatsApp Channel, users can verify if the webhook is set up correctly. If issues are detected, a "Fix Channel Issue" button appears. Clicking it will properly configure the webhook for that channel.

👨‍💻
Secret