Build on WhatsApp with one REST API.

curl https://whatsapp.aviraltechlab.com/api/v1/contacts/upsert \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919812345678",
    "name": "Asha Rao",
    "tags": ["vip"],
    "attributes": { "city": "Pune" }
  }'

curl https://whatsapp.aviraltechlab.com/api/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919812345678",
    "type": "interactive",
    "interactive": {
      "type": "button",
      "body": { "text": "Would you like to reorder?" },
      "buttons": [
        { "id": "reorder_yes", "title": "Yes, reorder" },
        { "id": "reorder_no", "title": "Not now" }
      ]
    }
  }'

curl "https://whatsapp.aviraltechlab.com/api/v1/contacts?tag=vip&limit=100" \
  -H "Authorization: Bearer $API_KEY"
# next page: add &after=<next_cursor> while has_more is true

curl https://whatsapp.aviraltechlab.com/api/v1/webhook_endpoints \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/whatsapp",
    "events": ["message.received", "message.failed"]
  }'

# 1. Groups of contacts with the same phone number
curl "https://whatsapp.aviraltechlab.com/api/v1/contacts/duplicates?reason=phone" \
  -H "Authorization: Bearer $API_KEY"

# 2. Keep one contact and merge the others into it (use the ids from step 1; chats and tags move over)
curl https://whatsapp.aviraltechlab.com/api/v1/contacts/$KEEP_ID/merge \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "source_ids": ["'"$DUPLICATE_ID"'"] }'

# 3. Opt out a list of numbers (unknown numbers become contacts so the opt-out holds)
curl https://whatsapp.aviraltechlab.com/api/v1/opt_outs \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phones": ["+919812345678", "9876500011"],
    "default_country": "IN",
    "reason": "Do-not-disturb registry sync"
  }'

curl https://whatsapp.aviraltechlab.com/api/v1/integrations/events \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: checkout-1042" \
  -d '{
    "source": "shopify",
    "topic": "checkouts/abandoned",
    "external_id": "checkout-1042",
    "contact": { "phone": "+919812345678", "name": "Asha Rao" },
    "create_contact": true,
    "payload": {"abandoned_checkout_url":"https://shop.example.com/cart/c-1042","total":1499}
  }'
# 202 { "automation_runs": [{ "automation_id": "…", "run_id": "…" }], "duplicate": false }

curl "https://whatsapp.aviraltechlab.com/api/hooks/automations/<AUTOMATION_ID>" \
  -H "X-Aviral-Hook-Token: $HOOK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+919812345678",
    "name": "Asha Rao",
    "order_number": "KC-10482",
    "total": 1499
  }'
# 202 { "runId": "…" }  (409 automation_not_active while the automation is not published)

# Subscribe (Zap switched on)
curl https://whatsapp.aviraltechlab.com/api/v1/webhook_endpoints \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.zapier.com/hooks/standard/123456/abcdef/",
    "events": ["message.received"],
    "source": "zapier"
  }'
# 201 { "id": "…", "secret": "whsec_…" }  (the secret is shown once)

# Unsubscribe (Zap switched off)
curl -X DELETE https://whatsapp.aviraltechlab.com/api/v1/webhook_endpoints/$ENDPOINT_ID \
  -H "Authorization: Bearer $API_KEY"