| Parameter | Type | Required | Description |
|---|---|---|---|
Authentication failed |
Auth | Optional | Confirm the App Key and Auth Key belong to the active BotLinkd configuration. Do not add spaces or use frontend-stored credentials. |
Missing parameter |
Validation | Optional | Send every required field using the exact name documented for the endpoint. |
Invalid recipient |
Validation | Optional | Use the international number format accepted by the connected account. |
Template unavailable |
Template | Optional | Verify the exact approved template name, language and placeholder order. |
Platform unavailable |
Account | Optional | Confirm the official WhatsApp Cloud API platform is connected and active. |
Message limit reached |
Plan | Optional | Review the active BotLinkd plan and available Cloud message allowance. |
Media URL rejected |
Media | Optional | Use a direct public HTTPS URL that matches the approved template header type. |
Temporary failure |
Transient | Optional | Use a bounded timeout and retry transient failures with backoff. Prevent duplicate messages in your own application. |
Do not depend on message text alone
Always inspect the HTTP status and safely parse the JSON response. Avoid logging App Keys, Auth Keys or private message content.