GET https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/conversations

Listar conversas

Inbox da instância: um item por número (`peer`), com a última mensagem e contagem. Inclui conversas importadas do histórico do WhatsApp no pareamento.

Parâmetros de path

Nome	Exemplo
`instance`	`dac3a956-4e8b-4d76-8caf-fed98dfc8b05`

Request

Headers

{
    "Accept": "application/json",
    "Authorization": "Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef"
}

Exemplos de código

curl -sS -X GET "https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/conversations" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef"

const response = await fetch('https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/conversations', {
  method: 'GET',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef',
  }
});
const data = await response.json();
console.log(data);

<?php

$ch = curl_init('https://api.instvia.com/api/v1/instances/dac3a956-4e8b-4d76-8caf-fed98dfc8b05/conversations');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer sk_live_0123456789abcdef0123456789abcdef0123456789abcdef',
    ],
]);
$body = curl_exec($ch);
curl_close($ch);
\$data = json_decode($body, true);

Response 200

{
    "success": true,
    "data": [
        {
            "peer": "5561991299129",
            "message_count": 12,
            "last_at": "2026-08-25T18:12:00+00:00",
            "last_message": {
                "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                "direction": "INBOUND",
                "type": "TEXT",
                "to": "5561991299129",
                "from": "556181637717",
                "peer": "5561991299129",
                "content": "Oi, recebi o boleto?",
                "status": "RECEIVED",
                "remote_id": null,
                "error_code": null,
                "error_message": null,
                "queued_at": "2026-08-25T18:10:00+00:00",
                "sent_at": null,
                "created_at": "2026-08-25T18:10:00+00:00"
            }
        }
    ]
}

Response 401

{
    "success": false,
    "error": {
        "code": "UNAUTHENTICATED",
        "message": "Invalid API key."
    }
}