Aprire la casella di posta dell’IA è un POST su /linkedin/webhooks/inbox, parte della famiglia webhooks della MakeHybrid API. Ogni richiesta porta la tua chiave in un header X-API-KEY; la chiave decide quale organizzazione sei e quindi quali account LinkedIn puoi nominare.
I webhook sono la differenza fra essere avvisati e continuare a chiedere. Verifica la firma a ogni consegna e tratta la ripetizione dello stesso evento come normale.
La richiesta
curl -X POST "https://makehybrid.com/linkedin/webhooks/inbox" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
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 l’id dell’account non è tuo. Le due risposte sono uguali di proposito, così gli id non si possono sondare.
- 429 — troppe richieste, o LinkedIn che frena l’account. Aspettare è l’unico rimedio; riprovare prima lo allunga.
- 503 — LinkedIn, o il salto davanti a lui, non ha risposto. Il corpo porta lo stato nudo che ha visto.
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/linkedin/mcp/<la tua chiave API> 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. Non c’è niente da installare.
In una stanza di progetto
In una stanza di progetto, spunta MakeHybrid sotto Può usare per un tuo agente IA, e questo chiama «Aprire la casella di posta dell’IA» come strumento ogni volta che la conversazione ne ha bisogno, sugli account LinkedIn che la tua organizzazione ha collegato. Tutti nella stanza vedono cosa ha chiesto e cosa è tornato. Chiedi a parole tue; qui l’agente si chiama @scout:
- @scout quali webhook abbiamo, e le loro ultime consegne sono andate a buon fine?
Domande frequenti
Un agente IA può chiamare «Aprire la casella di posta dell’IA» 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 MakeHybrid spuntato. Gli agenti integrati di una stanza no: consigliano, e non hanno la tua chiave LinkedIn.
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. La tua chiave decide quali account LinkedIn può nominare, in qualunque modo tu entri.
Funziona in una stanza con il mio marchio?
Sì. Su un indirizzo a marchio bianco lo strumento è elencato con il nome del tuo prodotto, e raggiunge gli stessi account con le stesse regole.
Una persona può approvare prima che un agente IA lo faccia?
Scrivilo nelle istruzioni dell’agente IA: dire cosa sta per fare e aspettare che una persona nella stanza dica «via». Una stanza mostra ogni risposta a tutti quelli che ci sono, quindi la richiesta si vede prima che cambi qualcosa su LinkedIn.
In quale piano
La MakeHybrid API, su /linkedin. 9 $ per account LinkedIn collegato al mese, 7 $ da dieci account e 5 $ da mille, con 30 giorni di prova per un account.