Відповідайте на всі канали з однієї скриньки

Завдання: одне місце, куди потрапляє кожне повідомлення клієнта, з якого б застосунку він не писав, і один виклик, який відповідає йому там само. П'ять кроків, у кожному по одному запиту.

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

Вирішена розмова знову відкривається сама, коли клієнт пише.

Часті запитання