WhatsApp Business

pepe.business manages the entire WhatsApp Business Platform (Meta) for you, including the purchase of dedicated numbers and KYC.

Purchasing a number

POST /v1/whatsapp/phone-numbers/purchase
{
  "country": "FR",
  "type": "mobile"
}

Response:

{
  "phoneNumber": "+33612345678",
  "id": "phn_xxx",
  "kycUrl": "https://kyc.pepe.business/abc",
  "kycStatus": "pending"
}

KYC is handled by pepe.business — you don't have to do anything on the Meta side.

Templates

Before sending a proactive message, you must create a Meta-approved template:

POST /v1/whatsapp/templates
{
  "name": "order_confirmation",
  "language": "fr",
  "category": "transactional",
  "body": [
    { "type": "text", "text": "Hello {{1}}, your order #{{2}} is confirmed." }
  ],
  "params": ["customer_name", "order_id"]
}

Meta typically approves within 1-24h. You are notified via the whatsapp.template.approved webhook.

Sending a message

Template

POST /v1/messages
{
  "platform": "whatsapp",
  "to": "+33612345678",
  "template": {
    "name": "order_confirmation",
    "params": ["Alice", "12345"]
  }
}

Text (within 24h of received message)

POST /v1/messages
{
  "platform": "whatsapp",
  "to": "+33612345678",
  "text": "Thanks for your feedback!"
}

Meta's "24h window" allows free messages only within 24h of the last user interaction. Beyond that, you must use a template.

WhatsApp Flows

Flows are interactive forms within WhatsApp:

POST /v1/whatsapp/flows
{
  "name": "Lead capture",
  "screens": [
    {
      "id": "screen_1",
      "title": "Your information",
      "fields": [
        { "name": "email", "type": "email", "required": true },
        { "name": "phone", "type": "tel", "required": true }
      ]
    }
  ]
}

Broadcasts

Send the same template to multiple recipients:

POST /v1/broadcasts
{
  "platform": "whatsapp",
  "templateName": "promo_summer",
  "recipients": ["+33611111111", "+33622222222", "+33633333333"],
  "params": [["Alice"], ["Bob"], ["Charlie"]]
}

Groups

pepe.business also manages WhatsApp Groups (beta):

• Create, add/remove members
• Send messages
• Retrieve messages

Sandbox

Test without a dedicated number via the sandbox:

POST /v1/whatsapp/sandbox/send
{
  "to": "+33612345678",
  "text": "Sandbox test"
}

Conversion events

For CTWA (Click-to-WhatsApp) ad tracking:

POST /v1/whatsapp/conversion-events
{
  "phoneNumber": "+33612345678",
  "event": "lead_captured",
  "value": 49.90,
  "currency": "USD"
}