Overview

The ChatYug External API lets your application send WhatsApp messages and query delivery status for a single WhatsApp Business Account (WABA) per API key.

What the External API covers

Send text and template messages
Upload media and send interactive button/list messages
Check message delivery status
Receive inbound events via outbound webhooks (configured in the portal)
Commerce — catalogs, product messages, orders, checkout Flows
Carousel — approved carousel template sends

Before your first API call, complete the setup checklist in API Configuration (API keys, webhook URL, and ID discovery).

Base URL

https://chatyug.com/api/external

Authentication

All endpoints except the health check require a Bearer token:

Authorization: Bearer ck_<your_api_key>

See Authentication for header usage, or the full key workflow in API Keys.

One key, one WABA

Each API key is scoped to one WABA. Use GET /api/external/me to list the phone numbers available for that key.

Customer service window (24-hour session)

Meta concept: Free-form session messages (text, media, interactive) can only be sent within 24 hours of the customer's last inbound message. Outside that window, you must use an approved template message.

Meta — Send messages (customer service window)

Template messages

Meta concept: Business-initiated messages outside the session window require pre-approved templates. Meta categorizes templates as utility, marketing, or authentication.

Meta — Template categories

Meta Cloud API

ChatYug proxies the WhatsApp Cloud API on your behalf. For protocol-level details (message object schemas, rate limits, policy), refer to Meta's documentation.