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.
Webhook Integration Overview

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.