Get a WhatsApp conversation

get /v1/whatsapp/{whatsapp_id}

Conversation metadata only: contact, seller, linked accounts and activity instants. A wa_ id issued to another company, or any id with a different prefix, is a 404, not a hint. A deleted chat keeps answering, with deleted_at and deleted_reason set.

Authorization

Requires the whatsapp.read scope.

Path parameters

Name	Type	Required	Description
`whatsapp_id`	`string`	Yes	—

Example request

curl "https://api.salesbud.com.br/v1/whatsapp/mtg_01JEXAMPLE" \
  -H "Authorization: Bearer $SALESBUD_ACCESS_TOKEN"

Example response

{
  "data": {
    "id": "wa_01JEXAMPLE",
    "object": "whatsapp_conversation",
    "source": "whatsapp_web",
    "is_group": false,
    "contact": {
      "phone": "+5511999990001",
      "name": "Cliente Exemplo"
    },
    "seller": {
      "user": {
        "id": "usr_01JEXAMPLE",
        "name": "Vendedora Exemplo",
        "email": "vendedora@example.com"
      },
      "phone": "+5511988880001"
    },
    "accounts": [
      {
        "id": "acc_01JEXAMPLE",
        "domain": "example.net",
        "cnpj": "00.000.000/0001-00"
      }
    ],
    "first_message_at": "2026-09-10T12:00:00.000Z",
    "last_message_at": "2026-09-12T15:30:00.000Z",
    "last_message_direction": "inbound",
    "deleted_at": null,
    "deleted_reason": null
  },
  "request_id": "req_ExampleRequestId01"
}

Responses

Status	Description
`200`	Company-scoped WhatsApp conversation.
`401`	Missing or invalid credentials.
`403`	The token does not contain the required scope.
`404`	Resource not found in the authenticated company.
`429`	Client rate limit exceeded.
`503`	A required audit or rate-limit dependency is unavailable.