Collegare un numero WhatsApp è un PUT su /whatsapp/v1/connection, nella MakeHybrid WhatsApp API: il numero WhatsApp della tua organizzazione, collegato come lo è WhatsApp Web. Ogni richiesta porta la tua chiave in un header X-API-KEY — la stessa chiave dell’API di LinkedIn — e raggiunge solo il numero che la tua organizzazione ha collegato.
Il numero è quello di un telefono vero, collegato come lo è WhatsApp Web: scrivi come fa una persona, con i ritmi di una persona, e a persone che si aspettano di sentirti.
La richiesta
curl -X PUT "https://makehybrid.com/whatsapp/v1/connection" \
-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/whatsapp/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 «Collegare un numero WhatsApp» 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 le mie conversazioni WhatsApp non lette e riassumi cosa ha chiesto ogni cliente.
Domande frequenti
Un agente IA può chiamare «Collegare un numero WhatsApp» 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.