API Reference

Conversations

List inbox conversations and retrieve message history.

Filter by channel Pass whatsapp_account_id to list only that channel. The filter is applied by Washeej; do not assume a client-side filter is required.

GET /conversations conversations:read

List inbox conversations.

Parameter	Type	Required	Description
`whatsapp_account_id`	integer	optional	Filter to one channel you own. Omit to list all channels.
`per_page`	integer	optional	Page size (default 25, max 100).

curl -H "client-id: YOUR_CLIENT_ID" \
     -H "client-secret: YOUR_CLIENT_SECRET" \
     "https://app.washeej.com/v1/conversations?whatsapp_account_id=YOUR_ACCOUNT_ID"

Notes

whatsapp_account_id is applied server-side. An unknown or foreign account ID returns an empty list, not every conversation.
last_message.media_url is the authenticated download URL when the latest message has media.

GET /conversations/{id}/messages messages:read

List messages in a conversation (newest first, paginated).

Parameter	Type	Required	Description
`id` path	integer	required	Conversation ID.
`per_page`	integer	optional	Page size.

curl -H "client-id: YOUR_CLIENT_ID" \
     -H "client-secret: YOUR_CLIENT_SECRET" \
     https://app.washeej.com/v1/conversations/20717/messages

Legacy note The older External API path /external-api/inbox/conversation-messages/{id} is also available. New integrations should use GET /v1/conversations/{id}/messages.