Pubblicare su X è un POST su /x/v1/2/tweets, nella MakeHybrid X API: l’account X della tua organizzazione, con le chiavi della tua app X. Ogni richiesta porta la tua chiave in un header X-API-KEY — la stessa chiave dell’API di LinkedIn — e raggiunge solo l’account che la tua organizzazione ha collegato.
Le chiamate partono con le chiavi della tua app X, quindi i limiti che valgono sono quelli della tua app, come li conta X per il suo piano.
La richiesta
curl -X POST "https://makehybrid.com/x/v1/2/tweets" \
-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 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/x/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 «Pubblicare su X» 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 mostra i messaggi diretti di oggi su X e scrivi una bozza di risposta a ciascuno.
Domande frequenti
Un agente IA può chiamare «Pubblicare su X» 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.
Una persona può approvare prima che un agente IA lo faccia?
Scrivilo nelle istruzioni dell’agente IA: dire cosa sta per inviare e aspettare che una persona nella stanza dica «via». Una stanza mostra ogni risposta a tutti quelli che ci sono, quindi le parole si vedono prima che raggiungano qualcuno all’esterno.
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.