Leggere una chat del sito web e il suo frammento di codice è un GET su /webchat/v1/widgets/{id}, 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/$ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Cosa va nel percorso
- id — un id restituito da una chiamata precedente di questa famiglia.
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 «Leggere una chat del sito web e il suo frammento di codice» 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 «Leggere una chat del sito web e il suo frammento di codice» 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.