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.

Autorização

Exige o escopo whatsapp.read.

Parâmetros de caminho

Nome	Tipo	Obrigatório	Descrição
`whatsapp_id`	`string`	Sim	—

Exemplo de requisição

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

Exemplo de resposta

{
  "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",
        "name": "Example Ltda",
        "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"
}

Respostas

Status	Descrição
`200`	Company-scoped WhatsApp conversation.
`401`	Missing or invalid credentials.
`403`	The token lacks the required scope, its user owner lost matching product access, or a connector awaits administrator approval. API_ACCESS_DISABLED identifies the feature gate for manual clients and third-party OAuth apps; AI_COLLABORATORS_DISABLED identifies the gate for first-party OAuth apps. For partner credentials, the gate also requires an active partner and the required published module, and applies to previously issued tokens.
`404`	Resource not found in the authenticated company, or outside what the owner of a user credential can see.
`429`	Client rate limit exceeded.
`503`	A required audit or rate-limit dependency is unavailable.