Отвечайте в ChatWoot из собственного кода

Ваша команда уже отвечает клиентам в 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"}'

Узнавать самим, а не спрашивать

Зарегистрируйте конечную точку вебхука, и каждое сообщение в любом разговоре этого 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"]}'

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