Il vostro team risponde già ai clienti in ChatWoot. Questo raggiunge lo stesso ChatWoot dal vostro codice — le sue inbox, ciò che è aperto, ciò che è stato detto e la risposta che inviate — senza una seconda inbox e senza spostare nulla.
Collegatelo una volta
Nella pagina delle stanze, dopo aver effettuato l'accesso: l'indirizzo della dashboard del vostro ChatWoot e un token di accesso di amministratore. Collegare aggiunge un webhook perché le risposte del team tornino; lasciare andare la connessione lo rimuove. L'API non accetta mai né l'uno né l'altro: POST /chatwoot/v1/connections/link risponde 403 con la pagina in cui vanno inseriti.
Cosa è aperto
curl "https://makehybrid.com/chatwoot/v1/connections" \ -H "X-API-KEY: $MAKEHYBRID_KEY" curl "https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations?status=open" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Ogni conversazione porta il contatto con cui è, l'agente a cui è assegnata, la sua inbox e quando si è mossa l'ultima volta. I suoi messaggi arrivano dal più vecchio al più recente, e ciascuno dice in che direzione è andato: incoming è quello del cliente, outgoing quello del team.
Rispondere, annotare, risolvere
curl -X POST https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"content":"It went out this morning — here is the tracking link."}'
curl -X PATCH https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"status":"resolved"}'
Inviate private a true e sarà una nota che il cliente non vede mai. Tutto il resto viene scritto come l'utente collegato e il cliente lo vede, quindi un agente che scrive per vostro conto scrive davanti al vostro cliente.
Farsi avvisare invece di chiedere
Registrate un endpoint webhook e ogni messaggio di qualsiasi conversazione di quel ChatWoot vi viene inviato: quello del cliente come chatwoot.message_received, quello del team come chatwoot.message_sent. Stessi endpoint, stessa firma di quelli della LinkedIn API.
curl -X POST https://makehybrid.com/chatwoot/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"url":"https://acme.com/hooks/chatwoot","events":["chatwoot.message_received"]}'
Domande frequenti
I miei clienti vedranno qualcosa di nostro?
No. È il vostro ChatWoot al vostro indirizzo, e tutto viene scritto come l'utente di cui è il token. Nulla viene rinominato e nulla di nostro è installato al suo interno.
Cosa succede quando ChatWoot è fuori servizio?
502 errors/chatwoot_unavailable, e nulla viene messo in coda o ritentato alle vostre spalle. Un token rifiutato è 409 errors/chatwoot_disconnected, il che significa che un membro deve ricollegarlo.
Un agente IA può rispondere lì ai clienti?
Può, tramite https://makehybrid.com/chatwoot/mcp/<la vostra chiave API> o in una stanza. Dategli istruzioni che dicano quando rispondere e quando lasciare invece una nota privata: il cliente vede tutto ciò che non è privato.