Elencare le chat del tuo sito web è un GET su /webchat/v1/widgets, nella MakeHybrid Website chat API: la chat propria della tua organizzazione sui suoi siti web, a cui rispondono il tuo team o i tuoi agenti IA. Ogni richiesta porta la tua chiave in un header X-API-KEY — la stessa chiave dell’API di LinkedIn — e raggiunge solo le tue chat.
La chat è tua, conservata da noi e non da un altro servizio di inbox: alla conversazione di un visitatore si arriva solo con la tua chiave, e un agente IA che risponde ai visitatori lo fa senza alcuno strumento.
La richiesta
curl -X GET "https://makehybrid.com/webchat/v1/widgets" \ -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/webchat/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 le chat del tuo sito web» 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 della chat del sito web a cui nessuno ha ancora risposto e scrivi una bozza di risposta per ciascuna, che controllerò io.
Domande frequenti
Un agente IA può chiamare «Elencare le chat del tuo sito web» 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.