Отвечайте на все каналы из одного ящика

Задача: одно место, куда попадает каждое сообщение клиента, из какого бы приложения он ни писал, и один вызов, который отвечает ему там же. Пять шагов, в каждом по одному запросу.

1. Создайте аккаунт ящика

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

Один раз на организацию. Повторный вызов возвращает тот же аккаунт, поэтому его безопасно запускать при каждом развёртывании.

2. Добавьте каналы

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

В ответ на запрос для чата на сайте вы получите сниппет, который нужно вставить перед </body>; он загружается с вашего собственного домена. Instagram и TikTok добавляются по ссылке для входа, Facebook Messenger — по ссылке, которую открывает менеджер страницы, а LINE, SMS и WhatsApp — с учётными данными самой платформы; в справочнике описан каждый.

3. Получайте новые сообщения

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

Сохраните секрет, который он вернёт: каждая доставка подписана им в заголовке x-mh-signature, а повтор того же события — это нормально.

4. Отвечайте там, где вам написали

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

Ответ уходит по собственному каналу разговора. Добавьте "private": true — и это заметка, которую видит только ваша команда.

5. Отметьте разговор решённым

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

Решённый разговор снова открывается сам, когда клиент пишет.

Частые вопросы