whatsapp

Get WhatsApp conversation messages

Changed on

Retrieves the message history of a WhatsApp conversation. Use limit_count and last_message_uuid for pagination; both are optional and limit_count defaults to 100.

Permission: Access is managed by the WhatsApp service. No specific API token permission is checked.

Monitoring: No impact.

get/whatsapp/conversations/{conversation_uuid}/messages

Request

  • Base URL
    https://public-api.ringover.com/v2
  • URL
    https://public-api.ringover.com/v2/whatsapp/conversations/{conversation_uuid}/messages
  • Auth
    API key in header Authorization

Path parameters

conversation_uuidstring uuid required
Example:1eb09f33-348e-42e6-bfb3-361df133c82e

The conversation UUID

Query parameters

limit_countinteger

Restrict the number of returned rows. Defaults to 100 when omitted.

last_message_uuidstring uuid
Example:1eb09f33-348e-42e6-bfb3-361df133c82e

Return messages older than this message UUID, for pagination.

Response

Successful operation — returns the message history.

total_messages_countinteger

Example response

{
  "total_messages_count": 42,
  "messages": [
    {
      "uuid": "1eb09f33-348e-42e6-bfb3-361df133c82e",
      "data": "Hello",
      "user_id": 1,
      "direction": "outbound",
      "status": "delivered"
    }
  ]
}

Changes