Top

Wapi documentation

## Webhook Integration

#### Welcome to WAPI!

Get an AI summary of this page
ChatGPT Gemini Grok Perplexity

#### 1. Overview

Webhook Integration is the bridge between your external business ecosystem and Wapi's conversational power. It allows you to transform events from E-commerce platforms, CRMs, or custom ERPs into automated, high-fidelity WhatsApp notifications.

Universal Hub
Wapi Webhooks are platform-agnostic. If your system can send a POST request, Wapi can process it and trigger a mapped response.

#### 2. Webhook Configuration

Setting up a webhook involves creating an endpoint in Wapi and mapping external payloads to specific message triggers.

###### Core Features

- Dynamic Endpoint Creation: Generate unique URLs for different incoming event sources.
- Cross-Platform Mapping: Align external event keys (e.g., "order_status") with WhatsApp Template triggers.
- Real-time Fulfillment: Instantly notify customers of shipment updates, payment confirmations, or policy changes.

#### 3. Implementation Protocol

Follow these steps to synchronize your business events with WhatsApp messages.

###### Step 1: Generate Webhook URL

- Navigate to Webhooks in the Wapi sidebar.
- Click on + Create Webhook.
- Copy the generated Webhook URL and Secret Key.

###### Step 2: External System Setup

- Go to your platform's Webhook settings (e.g., Shopify, WooCommerce).
- Paste the Wapi Webhook URL.
- Select the events you wish to track (e.g., "Order Created", "Subscription Cancelled").

###### Step 3: Trigger & Template Mapping

- Back in Wapi, map the incoming event to a specific WhatsApp Template.
- Define conditional triggers if you only want messages sent under specific circumstances.
- Click Activate to begin live processing.

###### Scenario: Payment Failure Alert

Recover lost revenue with proactive conversational alerts.

- Trigger Source: Payment Gateway (Stripe/Razorpay).
- Event: `charge.failed`.
- Wapi Action: Send "Payment Link" template with a direct checkout button.

#### 4. Strategic Governance

###### Integration Best Practices

- Security First: Always verify the incoming payload with the Wapi Secret Key to prevent spoofing.
- Rate Management: Ensure your external system doesn't exceed WhatsApp's messaging rate limits during bulk events.
- Message Sequencing: Use Delays to avoid overwhelming customers with multiple webhooks at once.

Operational Tip: Monitor the Webhook Logs daily to identify any failed payload deliveries or mapping errors.