Use this file to discover all available pages before exploring further.
The API offers four ways to send a WhatsApp message on behalf of your business.
Which one you can use depends on the state of the conversation’s
24h window.
The template is the only message you can send with the window closed. On
top of that, sending one reopens the window, enabling text, media, and quick
reply again.
Free-form text, up to 4096 characters, via POST /conversation/messages/text.
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text" \ -H "Authorization: Bearer sk_1to1_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "conversation": { "phone": "+5215512345678" }, "body": "Hi 👋, how can I help you?" }'
Accepts an optional reply_to_uuid to quote a previous message. Responds
201 with message_uuid and wamid.
Image, video, audio, or document — same endpoint as text
(POST /conversation/messages/text), passing a file_uuid instead of —or
alongside— body as the caption.
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text" \ -H "Authorization: Bearer sk_1to1_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "conversation": { "phone": "+5215512345678" }, "file_uuid": "7b8a...", "body": "Here is your receipt 📄" }'
The file_uuid must belong to a file already uploaded and confirmed, from
the same business. The message type (image, video, audio, document) is
inferred automatically from the file. See the /files flow in the API
Reference.
A reply preconfigured in the dashboard, via
POST /conversation/messages/quick-reply. Identified by quick_reply_uuid
or by quick_reply.name.
A quick reply can emit several messages, which is why the response is an
array messages with a message_uuid, wamid, and subtype for each one.
A template approved by Meta, via POST /conversation/messages/template. It
is the only mode that works with the window closed — see
Templates for the detail.
