WhatsApp agentsMessages
List messages
Returns a conversation's messages, oldest first. By default the latest limit messages.
/v2/whatsapp/conversations/{id}/messagesAuthorization
AuthorizationstringheaderrequiredBearer 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)requiredThe conversation's id.
Query parameters
limitintegerMaximum messages to return (1-500).
Default:200beforestring (date-time)Page further back: only messages created before this time.
updated_sincestring (date-time)Only messages created or whose delivery status changed after this time.
Response
An array of message objects.
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.
wamidstringnullableWhatsApp's own message id.
directionstringinbound(from the customer) oroutbound.Allowed:inboundoutboundsender_typestringcustomer,agent(the AI) orhuman(a person on your team or the API).Allowed:customeragenthumanmessage_typestringe.g.
text,template,image.bodystringnullableMessage text.
template_namestringnullableTemplate name, for template messages.
statusstringreceived,pending,sent,delivered,readorfailed.errorstringnullableWhy delivery failed, if it did.
created_atstring (date-time)nullableWhen the message was sent or received.
updated_atstring (date-time)nullableWhen its status last changed.