Odpowiadaj na wszystkie kanały z jednej skrzynki odbiorczej

Zadanie: jedno miejsce, w którym ląduje każda wiadomość klienta, z jakiejkolwiek aplikacji by przyszła, i jedno wywołanie, które odpowiada na nią właśnie tam. Pięć kroków, każdy to jedno żądanie.

1. Utwórz konto skrzynki odbiorczej

curl -X POST https://makehybrid.com/inbox/v1/account \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

Raz na organizację. Ponowne wywołanie zwraca to samo konto, więc można je bezpiecznie uruchamiać przy każdym wdrożeniu.

2. Dodaj kanały

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…"}}'

Czat na stronie odpowiada fragmentem kodu do wklejenia przed </body>; ładuje się z twojej własnej domeny. Instagram i TikTok dodaje się linkiem logowania, Facebook Messenger linkiem, który otwiera administrator strony, a LINE, SMS i WhatsApp własnymi danymi dostępowymi platformy — dokumentacja opisuje każdy z nich.

3. Odbieraj nowe wiadomości

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"]}'

Zachowaj sekret, który zwraca: każda dostawa jest nim podpisana w nagłówku x-mh-signature, a powtórzenie tego samego zdarzenia jest normalne.

4. Odpowiedz tam, gdzie napisali

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"}'

Odpowiedź wychodzi kanałem samej rozmowy. Dodaj "private": true, a będzie to notatka widoczna tylko dla twojego zespołu.

5. Zamknij ją

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"}'

Rozwiązana rozmowa otwiera się sama, gdy klient napisze.

O co ludzie pytają