Posta in arrivo
Elenca i contatti
Elenca il tuo profilo, stage e interessi senza rivelare il tuo numero di telefono o e-mail.
GET
/inbox/contactsinbox:readCOMPORTAMENTO
La lettura rispetta i filtri e restituisce solo le risorse visibili all'account collegato alla chiave.
EFFETTO
Non modifica le risorse né attiva la pubblicazione.
RIPETIZIONE
L'operazione è sicura da ripetere. Su 429 o 5xx, utilizzare il backoff esponenziale con jitter.
Richiesta
limitinteger · queryQuantità per pagina.min 1 · max 100 · default 30facoltativooffsetinteger · queryOffset della paginazione.min 0 · default 0facoltativoquerystring · queryRicerca testuale.facoltativostagestring · queryTirocinio CRM.facoltativoAuthorization
Bearer ach_live_...Accept
application/jsonAmbito
inbox:readEsempio eseguibile
curl
curl 'https://achadu.com/api/v1/inbox/contacts' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json'Risposta ed errori
Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.
200 application/json
{
"data": [
{
"id": "conv_01J...",
"channel": "instagram",
"status": "open",
"priority": "normal",
"intent": "find_offer",
"sentiment": "positive",
"unread_count": 1
}
],
"pagination": {
"total": 1,
"limit": 30,
"offset": 0,
"has_more": false
},
"request_id": "req_01J..."
}200Operazione completata.400Parametro, corpo o transizione non validi.401Chiave mancante, non valida, scaduta o revocata.402Il piano dell'account non rilascia questa interfaccia.403A chave precisa do escopo inbox:read.404La funzionalità non esiste in questo account.409Lo stato attuale impedisce questa operazione.413Il corpo JSON supera i 128 KB.429La finestra di 120 richieste al minuto è stata superata.