自分のコードから ChatWoot に返信する

チームはすでに ChatWoot でお客様に返信しています。これは、同じ ChatWoot に自分のコードから届くものです。受信トレイ、開いている会話、交わされた内容、あなたが送る返信まで。2 つ目の受信トレイを作ることも、何かを移すこともありません。

一度だけ接続する

ルームのページで、サインインした状態で、ChatWoot ダッシュボードのアドレスと、管理者のアクセストークンを入れます。接続するとチームの返信が戻ってくるように Webhook が 1 つ追加され、接続を外すと削除されます。API がこの 2 つを受け取ることはありません。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"}'

聞きに行かず、知らせてもらう

Webhook のエンドポイントを登録すると、その 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"]}'

よくある質問