Il compito: un unico posto dove arriva ogni messaggio dei clienti, da qualunque app scrivano, e un'unica chiamata che risponde loro lì. Cinque passaggi, ognuno una richiesta.
1. Create l'account inbox
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Una volta per organizzazione. Chiamarlo di nuovo restituisce lo stesso account, quindi si può eseguire senza rischi a ogni deploy.
2. Aggiungete i canali
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'
La chat web risponde con lo snippet da incollare prima di </body>; si carica dal vostro dominio. Instagram e TikTok si aggiungono con un link di accesso, Facebook Messenger con un link che apre chi gestisce una pagina, e LINE, SMS e WhatsApp con le credenziali della piattaforma stessa — la documentazione di riferimento descrive ciascuno.
3. Ricevete i nuovi messaggi
curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'
Conservate il segreto che restituisce: ogni consegna è firmata con esso nell'header x-mh-signature, e che lo stesso evento arrivi più volte è normale.
4. Rispondete dove vi hanno scritto
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'
La risposta parte sul canale della conversazione stessa. Aggiungete "private": true e diventa una nota che vede solo il vostro team.
5. Risolvetela
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"status":"resolved"}'
Una conversazione risolta si riapre da sola quando il cliente scrive.
Alcuni canali lasciano scrivere per primo a un'azienda solo con un modello approvato dalla piattaforma — WhatsApp fuori dalla sua finestra di 24 ore è il caso comune. Rispondere è sempre permesso; iniziare lo decide la piattaforma.
Domande frequenti
Il mio team può rispondere senza scrivere codice?
Sì. La schermata Inbox dell'app installata mostra le stesse conversazioni a ogni membro che ha effettuato l'accesso, con risposte, note private, assegnazione, etichette e notifiche sul telefono.
Un agente IA può scrivere le bozze delle risposte?
Sì. Date a un vostro agente IA l'agente dell'inbox in una stanza di progetto, oppure collegate il vostro assistente a /inbox/mcp, e chiedetegli di scrivere la bozza; una persona nella stanza dice «vai» prima che venga inviato qualcosa.