WhatsApp

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "whatsapp" }'

{
  "auth_url": "",
  "state": "<CSRF token, bound to your API key, 10-minute TTL>",
  "metadata": {
    "app_id": "...",
    "config_id": "...",
    "solution_id": "..."
  }
}

FB.login(
  (response) => {
    const code = response.authResponse?.code;
    // send code (plus waba_id + phone_number_id from the event below) to your backend
  },
  {
    config_id: CONFIG_ID,
    response_type: "code",
    override_default_response_type: true,
    extras: { setup: { solutionID: SOLUTION_ID } },
  },
);

curl -X POST https://api.social-api.ai/v1/oauth/exchange \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "whatsapp",
    "code": "<from the popup>",
    "metadata": {
      "state": "<from leg 1>",
      "waba_id": "<from the popup>",
      "phone_number_id": "<from the popup>"
    }
  }'

extras: {
  setup: { solutionID: SOLUTION_ID },
  featureType: "whatsapp_business_app_onboarding",
  sessionInfoVersion: "3",
},

curl -X POST https://api.social-api.ai/v1/platforms/whatsapp/accounts/{account_id}/templates \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "order_confirmation",
    "category": "UTILITY",
    "language": "en_US",
    "components": [
      {
        "type": "BODY",
        "text": "Hello {{1}}, your order {{2}} is confirmed.",
        "example": { "body_text": [["Jordan", "A1234"]] }
      }
    ]
  }'

curl -X POST https://api.social-api.ai/v1/platforms/whatsapp/accounts/{account_id}/send-template \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "15551234567",
    "template_name": "order_confirmation",
    "language": "en_US",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Jordan" },
          { "type": "text", "text": "A1234" }
        ]
      }
    ]
  }'

curl "https://api.social-api.ai/v1/inbox/conversations?account_id={id}" \
  -H "Authorization: Bearer $SOCIALAPI_KEY"

curl -X POST https://api.social-api.ai/v1/inbox/conversations/{conversation_id}/messages \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "{account_id}",
    "text": "Thanks for reaching out!"
  }'

curl -X POST https://api.social-api.ai/v1/inbox/conversations/{conversation_id}/messages \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "{account_id}",
    "attachments": [
      { "source_type": "media_id", "source": "{media_id}", "caption": "The damaged panel" }
    ]
  }'

curl -X POST https://api.social-api.ai/v1/inbox/conversations/{conversation_id}/messages \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "{account_id}",
    "text": "Your weekly digest is ready. What next?",
    "buttons": [
      { "type": "postback", "title": "Review drafts", "payload": "menu:review_drafts" },
      { "type": "postback", "title": "Skip this week", "payload": "menu:skip" }
    ]
  }'

curl -X POST https://api.social-api.ai/v1/inbox/conversations/{conversation_id}/messages \
  -H "Authorization: Bearer $SOCIALAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "{account_id}",
    "text": "Which location?",
    "list_button": "View locations",
    "list_sections": [
      {
        "title": "Your locations",
        "rows": [
          { "id": "loc:1", "title": "Downtown", "description": "3 reviews waiting" },
          { "id": "loc:2", "title": "Airport" }
        ]
      }
    ]
  }'

{
  "content": { "text": "Review drafts" },
  "metadata": {
    "platform_id": "wamid.xxx",
    "interactive_type": "button_reply",
    "payload": "menu:review_drafts"
  }
}