Skip to main content
PingPilot supports WhatsApp notifications using the WhatsApp Business API (Meta Cloud API), allowing you to receive event alerts directly in WhatsApp.
WhatsApp integration is currently available for Enterprise plans only and requires manual setup by the PingPilot team.

​
How It Works

The WhatsApp integration uses Meta’s WhatsApp Business Cloud API to:
  1. Send notifications to verified WhatsApp numbers
  2. Use pre-approved message templates
  3. Deliver real-time event notifications
WhatsApp has strict requirements for business messaging. All message templates must be approved by Meta before use.

​
Prerequisites

To use WhatsApp notifications, you need:
  • Enterprise Plan: WhatsApp is available for Enterprise customers only
  • WhatsApp Account: A valid WhatsApp account with the registered number
  • Manual Setup: Contact PingPilot support to enable WhatsApp for your account

​
Setup Process

1

Contact Support

Reach out to PingPilot support to request WhatsApp integration
2

Provide Your Number

Submit your WhatsApp number in international format (e.g., +1234567890)
3

Verification

Complete the verification process with Meta
4

Template Approval

Wait for message templates to be approved by Meta (typically 24-48 hours)
5

Configuration

PingPilot team will configure your account with WhatsApp access

​
Technical Implementation

The WhatsApp integration uses Meta’s Graph API: 
// Source: src/lib/whatsapp.ts
const WHATSAPP_API_URL = 
  "https://graph.facebook.com/v22.0/574181239111657/messages"

export async function sendWhatsappTextMessage() {
  const response = await fetch(WHATSAPP_API_URL, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.WHATSAPP_TOKEN}`,
    },
    body: JSON.stringify({
      messaging_product: "whatsapp",
      to: "919133533051",
      type: "template",
      template: { 
        name: "hello_world", 
        language: { code: "en_US" } 
      },
    }),
  })
}
See the implementation in src/lib/whatsapp.ts:4.

​
Message Templates

WhatsApp requires pre-approved message templates. The current implementation uses:
  • Template Name: hello_world
  • Language: English (en_US)
  • Type: Notification template
Custom event templates are being developed. Currently, WhatsApp integration uses a basic template for testing.

​
API Configuration

The WhatsApp integration requires:

​
Environment Variables

  • WHATSAPP_TOKEN: Meta access token for WhatsApp Business API
  • Phone number configured in Meta Business Suite

​
API Endpoint

The integration uses: 
POST https://graph.facebook.com/v22.0/{PHONE_NUMBER_ID}/messages

​
Current Limitations

The WhatsApp integration is in active development. Current limitations include:
  1. Template Only: Currently limited to pre-approved templates
  2. No Custom Fields: Event-specific data not yet supported in messages
  3. Manual Configuration: Requires PingPilot team setup
  4. Enterprise Only: Available for Enterprise plan customers
  5. Single Number: Hardcoded recipient in current implementation

​
Future Enhancements

Planned improvements for WhatsApp integration:
  • Dynamic event templates with custom fields
  • User-configurable phone numbers in account settings
  • Rich media support (images, documents)
  • Interactive button messages
  • Delivery status tracking
  • Template management interface

​
WhatsApp Business Requirements

To use WhatsApp Business API, your organization must:
  1. Business Verification: Complete Meta Business verification
  2. Phone Number: Provide a dedicated business phone number
  3. Compliance: Follow WhatsApp Business Policy guidelines
  4. Templates: Get message templates approved by Meta
The PingPilot team handles most of these requirements. You just need to provide your WhatsApp number and complete verification.

​
Testing WhatsApp Integration

Currently, WhatsApp testing is handled by the PingPilot team: 
// Test endpoint
POST /api/test
This sends a test message using the hello_world template.
User-facing WhatsApp testing will be available once custom templates are implemented.

​
Troubleshooting

Possible reasons:
  1. You’re not on an Enterprise plan
  2. WhatsApp hasn’t been enabled for your account
  3. Contact PingPilot support to enable WhatsApp
Check the following:
  1. Verify your phone number is correctly registered
  2. Ensure you have WhatsApp installed and active
  3. Check if you’ve blocked the PingPilot business number
  4. Contact support to verify your configuration
If your custom templates are pending:
  1. Meta typically reviews templates within 24-48 hours
  2. Check your Meta Business Suite for approval status
  3. Contact PingPilot support for assistance
WhatsApp Business API has rate limits:
  1. Tier-based messaging limits (1K, 10K, 100K+ messages/day)
  2. Your tier increases automatically based on quality and volume
  3. Contact support if you need higher limits

​
WhatsApp vs Other Channels

FeatureWhatsAppDiscordTelegramEmail
Setup ComplexityHighLowLowNone
Real-timeYesYesYesDelayed
Rich FormattingLimitedFullModerateFull
Template RequiredYesNoNoNo
Self-ServiceNoYesYesYes
Plan RequirementEnterpriseAllAllAll

​
Requesting WhatsApp Access

To enable WhatsApp notifications:
  1. Upgrade to Enterprise: Ensure you’re on an Enterprise plan
  2. Contact Support: Email [email protected] with:
    • Your account email
    • WhatsApp number (international format)
    • Business name for verification
  3. Complete Verification: Follow Meta’s verification process
  4. Wait for Setup: PingPilot team will configure your account
Enterprise customers can contact their account manager directly for WhatsApp setup.

​
Pricing

WhatsApp messaging costs:
  • Included in Enterprise Plan: First 1,000 messages/month
  • Overage: $0.005 per message (after included quota)
  • Template Fees: Waived for PingPilot customers
Pricing is subject to change based on Meta’s WhatsApp Business API pricing.

​
Compliance

WhatsApp Business messaging must comply with:
  • 24-hour Window: Free-form messages only within 24 hours of user contact
  • Templates Required: Outside 24-hour window, use approved templates
  • Opt-in Required: Users must opt-in to receive business messages
  • Privacy Policy: Must have a privacy policy for business messaging
Violations of WhatsApp Business Policy can result in account suspension. PingPilot ensures compliance through template-based messaging.

​
Next Steps

Contact Sales

Discuss Enterprise plan and WhatsApp access

Other Integrations

Explore other notification channels

Build docs developers (and LLMs) love

Get started for freeTalk to us