Mensagens

Consulte o histórico de mensagens da empresa — a lista geral com filtros ou o histórico de um contato específico. Ambos exigem plano Enterprise e são paginados.

escopo: messages:readEnterprise

Lista mensagens da empresa. Filtros: ?contact_id=&connection_id=&direction=inbound&type=text&status=delivered&from=&to=&page=1&limit=50

Resposta (200)

Corpo da resposta
{
  "success": true,
  "data": [
    {
      "id": "<uuid>",
      "contact_id": "<uuid>",
      "direction": "inbound",
      "type": "text",
      "content": "Olá, tudo bem?",
      "media_url": null,
      "media_mimetype": null,
      "media_filename": null,
      "media_caption": null,
      "status": "delivered",
      "sender_type": "contact",
      "wamid": "<id-da-meta-ou-provider>",
      "external_id": null,
      "quoted_message_id": null,
      "quoted_content": null,
      "quoted_type": null,
      "connection_id": "<uuid>",
      "is_edited": false,
      "edited_at": null,
      "created_at": "2026-07-15T09:20:00.000Z",
      "timestamp": "2026-07-15T09:20:00.000Z",
      "contacts": {
        "id": "<uuid>",
        "phone": "5548999990000",
        "name": "João Silva",
        "display_name": "João Silva",
        "source_platform": "whatsapp"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 240,
    "total_pages": 5
  }
}

Exemplo

curl
curl -s -H "Authorization: Bearer <sua-key>" https://www.prosalab.com/api/v1/messages
escopo: messages:readEnterprise

Histórico de mensagens de um contato. Filtros: ?from=&to=&direction=&page=1&limit=50

Resposta (200)

Corpo da resposta
{
  "success": true,
  "data": [
    {
      "id": "<uuid>",
      "direction": "outbound",
      "type": "text",
      "content": "Seu pedido foi confirmado.",
      "media_url": null,
      "media_mimetype": null,
      "media_filename": null,
      "media_caption": null,
      "status": "sent",
      "sender_type": "system",
      "wamid": "<id-da-meta-ou-provider>",
      "quoted_message_id": null,
      "quoted_content": null,
      "quoted_type": null,
      "connection_id": "<uuid>",
      "is_edited": false,
      "edited_at": null,
      "created_at": "2026-07-15T09:22:00.000Z",
      "timestamp": "2026-07-15T09:22:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 12,
    "total_pages": 1
  }
}

Erros

StatusCódigoQuando ocorre
404NOT_FOUNDContato não existe ou pertence a outra empresa

Exemplo

curl
curl -s -H "Authorization: Bearer <sua-key>" https://www.prosalab.com/api/v1/contacts/{id}/messages
Mensagens — Prosalab Developers