Ваша команда вже відповідає клієнтам у ChatWoot. Це дає доступ до того самого ChatWoot зі свого коду — до його скриньок, відкритих розмов, сказаного й відповіді, яку ви надсилаєте, — без другої скриньки й без перенесення чогось.
Підключіть один раз
На сторінці проєктних кімнат, після входу: адреса вашої панелі ChatWoot і токен доступу адміністратора. Під час підключення додається один вебхук, щоб відповіді команди поверталися; коли ви відключаєте ChatWoot, він видаляється. API не приймає жодного з них: POST /chatwoot/v1/connections/link відповідає 403 з адресою сторінки, на якій це вводиться.
Що відкрито
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"
У кожної розмови вказано контакт, з яким вона йде, агента, якому її призначено, скриньку й час останнього руху. Повідомлення йдуть від старих до нових, і кожне показує напрямок: incoming — від клієнта, outgoing — від команди.
Відповісти, залишити нотатку, позначити вирішеною
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"}'
Надішліть "private": true — і це нотатка, якої клієнт ніколи не побачить. Усе інше записується від імені підключеного користувача, і клієнт це бачить, тож агент, який пише від вашого імені, пише на очах у вашого клієнта.
Дізнаватися самим, а не питати
Зареєструйте кінцеву точку вебхука, і кожне повідомлення в будь-якій розмові цього ChatWoot надсилатиметься на неї: клієнтське — як chatwoot.message_received, командне — як chatwoot.message_sent. Ті самі кінцеві точки й той самий підпис, що й у 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"]}'
Часті запитання
Чи побачать мої клієнти щось від вас?
Ні. Це ваш ChatWoot за вашою адресою, і все записується від імені користувача, чий це токен. Ніщо не змінює бренд, і нічого нашого в ньому не встановлюється.
Що буде, якщо ChatWoot недоступний?
502 errors/chatwoot_unavailable, і нічого не ставиться в чергу й не повторюється у вас за спиною. Відхилений токен — це 409 errors/chatwoot_disconnected: учасникові потрібно підключити його знову.
Чи може ШІ-агент відповідати там клієнтам?
Може — через https://makehybrid.com/chatwoot/mcp/<your API key> або в кімнаті. Дайте йому інструкції, коли відповідати, а коли залишати приватну нотатку: клієнт бачить усе, що не приватне.