Senders Flow Guide

Purpose

Use this flow when onboarding a tenant or fixing sender readiness. Outcome should be at least one sender in connected + registered state.

Prerequisites

• Valid Bearer token for tenant workspace.
• Business account already connected in WhatsApp setup.
• Meta registration PIN available (6 digits).

Step 1: Sync Sender Data

POST /api/whatsapp/sync

curl -X POST "https://api.smsport.in/api/whatsapp/sync" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "businessAccountId": "<BUSINESS_ACCOUNT_ID>"
  }'

Step 2: List Sender Numbers

GET /api/whatsapp/phone-numbers

Pick the id you want to register from phoneNumbers[]. Direct endpoint doc:List Senders API

Step 3: Register Sender

POST /api/whatsapp/phone-numbers/:phoneNumberId/register-sender

{
  "pin": "123456"
}

Direct endpoint doc:Create Sender API

Step 4: Verify Final State

Re-run list endpoint and confirm the selected number has:

{
  "status": "connected",
  "registrationStatus": "registered",
  "provisioningStage": "sender_registered"
}

Common Errors

• 400 pin must be a 6-digit number: fix payload format.
• No phone numbers after sync: business account not fully connected or wrong tenant.
• Sender not connected: run sync again and verify Meta status/health first.