Elencare tutti gli agenti della casella di posta è un GET su /inbox/v1/agents, nella MakeHybrid Inbox API: un’unica casella di posta per WhatsApp, Instagram, Facebook, TikTok, Telegram, LINE, e-mail, SMS e la chat del tuo sito. Ogni richiesta porta la tua chiave in un header X-API-KEY — la stessa chiave dell’API di LinkedIn — e raggiunge solo l’account della casella di posta della tua organizzazione.
Una casella di posta riunisce tutti i canali che le aggiungi, quindi la risposta torna sul canale su cui ha scritto il cliente — WhatsApp, Instagram, e-mail o qualsiasi altro — con la stessa chiamata.
La richiesta
curl -X GET "https://makehybrid.com/inbox/v1/agents" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Cosa torna quando non funziona
- 401 — la chiave manca, è sbagliata o è stata revocata.
- 402 — il piano non è pagato. La MakeHybrid API risponde così quando la prova è finita.
- 404 — o la cosa non c’è, o non è della tua organizzazione. Le due risposte sono uguali di proposito, così gli id non si possono sondare.
- 429 — troppe richieste, o la piattaforma che ci chiede di rallentare. Aspetta un momento prima di riprovare.
- 502 o 503 — la piattaforma non ha risposto proprio ora. Riprova tra un momento.
Ogni errore è JSON nella stessa forma: {"type":"errors/<code>","status":<n>,"detail":"..."} — così un solo gestore li copre tutti, e il detail è scritto per essere mostrato a una persona.
Chiederlo a un assistente
Questa operazione è anche uno strumento MCP. Incolla https://makehybrid.com/inbox/mcp/<your API key> in Claude, ChatGPT o qualunque assistente che parli MCP e chiedi quello che vuoi in italiano — l’assistente sceglie la chiamata, riempie gli id e ti legge la risposta. Anche l’agente tutto in uno di https://makehybrid.com/mcp/<your API key> ce l’ha, insieme all’API di LinkedIn e a tutti gli altri canali.
In una stanza di progetto
In una stanza di progetto, spunta l’agente di questa API sotto Può usare per un tuo agente IA, e questo chiama «Elencare tutti gli agenti della casella di posta» come strumento ogni volta che la conversazione ne ha bisogno. Tutti nella stanza vedono cosa ha chiesto e cosa è tornato. Chiedi a parole tue; qui l’agente si chiama @scout:
- @scout elenca le conversazioni aperte di oggi da tutti i canali e scrivi una bozza di risposta alla più vecchia.
Domande frequenti
Un agente IA può chiamare «Elencare tutti gli agenti della casella di posta» per me?
Sì. Può farlo qualsiasi assistente che parli MCP, tramite l’indirizzo qui sopra, e così un tuo agente IA in una stanza di progetto con l’agente di questa API spuntato. Gli agenti integrati di una stanza no: consigliano, e non hanno la tua chiave.
Funziona fuori da una stanza, dal mio codice?
Sì. La richiesta qui sopra è la stessa operazione che chiama lo strumento di un agente IA, con la stessa risposta e gli stessi errori, e la tua chiave raggiunge gli stessi canali, in qualunque modo tu entri.
Funziona in una stanza con il mio marchio?
Sì. Su un indirizzo a marchio bianco l’API, il suo riferimento e il suo agente IA portano il nome del tuo prodotto, e raggiungono gli stessi canali con le stesse regole.
In quale piano
Fa parte del piano MakeHybrid API, con la stessa chiave dell’API di LinkedIn: 9 $ per postazione al mese, 7 $ da dieci postazioni e 5 $ da mille. Ti servono tante postazioni quante ne hai del tipo più numeroso — account LinkedIn, numeri WhatsApp, account X o account della casella di posta — e la prova di 30 giorni ne copre una.