WhatsApp agentsMessages

Send message

Sends a text reply from the conversation's WhatsApp number as a person (sender_type: human). The AI agent is paused on the conversation so it doesn't reply over you -- resume it with Update conversation.

POST/v2/whatsapp/conversations/{id}/messages

WhatsApp only allows free-form messages within 24 hours of the customer's last message. Outside that window this returns 409.

Authorization

Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <api_key>, where <api_key> is a key from Account Settings → API keys in your dashboard.

Path parameters

idstring (uuid)required
The conversation's id.

Request body

application/json

textstringrequired
Message text, 1-4096 characters.

Response

The sent message object.

Show all 13 fieldsHide fields

idstring (uuid)
Message id.
conversation_idstring (uuid)
Conversation the message belongs to.
tenant_idstring (uuid)
The workspace that owns the message.
wamidstringnullable
WhatsApp's own message id.
directionstring
inbound (from the customer) or outbound.
Allowed:inboundoutbound
sender_typestring
customer, agent (the AI) or human (a person on your team or the API).
Allowed:customeragenthuman
message_typestring
e.g. text, template, image.
bodystringnullable
Message text.
template_namestringnullable
Template name, for template messages.
statusstring
received, pending, sent, delivered, read or failed.
errorstringnullable
Why delivery failed, if it did.
created_atstring (date-time)nullable
When the message was sent or received.
updated_atstring (date-time)nullable
When its status last changed.

curl --request POST \ --url 'https://api.tarangnow.com/v2/whatsapp/conversations/d2c3b4a5-9687-4f1e-8d2c-3b4a59687f1e/messages' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{ "text": "Sure! You'\''ll need ID proof, address proof and your last 3 salary slips." }'

{ "id": "0a1b2c3d-4e5f-4061-9283-a4b5c6d7e8f9", "conversation_id": "d2c3b4a5-9687-4f1e-8d2c-3b4a59687f1e", "tenant_id": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d", "wamid": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgSQTFCMkMzRDRFNUY2QTdCOEMA", "direction": "outbound", "sender_type": "human", "message_type": "text", "body": "Sure! You'll need ID proof, address proof and your last 3 salary slips.", "template_name": null, "status": "sent", "error": null, "created_at": "2026-10-24T14:03:11.508Z", "updated_at": "2026-10-24T14:03:11.508Z" }

Response

The sent message object.

Show all 13 fieldsHide fields

idstring (uuid)
Message id.
conversation_idstring (uuid)
Conversation the message belongs to.
tenant_idstring (uuid)
The workspace that owns the message.
wamidstringnullable
WhatsApp's own message id.
directionstring
inbound (from the customer) or outbound.
Allowed:inboundoutbound
sender_typestring
customer, agent (the AI) or human (a person on your team or the API).
Allowed:customeragenthuman
message_typestring
e.g. text, template, image.
bodystringnullable
Message text.
template_namestringnullable
Template name, for template messages.
statusstring
received, pending, sent, delivered, read or failed.
errorstringnullable
Why delivery failed, if it did.
created_atstring (date-time)nullable
When the message was sent or received.
updated_atstring (date-time)nullable
When its status last changed.