目的：お客様があなたの WhatsApp 番号に書き込み、AI エージェントが返信を下書きし、送る前に人が承認する。番号はスマートフォンの中のあなたのままで、誰も読んでいないものは送られません。
1. 番号をリンクする
curl -X POST https://makehybrid.com/whatsapp/v1/connection/link \ -H "X-API-KEY: $MAKEHYBRID_KEY"
返ってきた url をコンピューターで開き、WhatsApp の「設定」、「リンク済みのデバイス」、「デバイスをリンク」からスマートフォンでコードをスキャンします。そのあと GET /whatsapp/v1/connection を呼ぶと、番号が接続済みと表示されます。
2. お客様の書き込みを受け取る
curl -X POST https://makehybrid.com/whatsapp/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/whatsapp","events":["whatsapp.message_received"]}'
3. 下書き、承認、送信
プロジェクトルームで、自分の AI エージェントに「使えるサーバー」で WhatsApp のエージェントを渡し、指示を書きます。新しいメッセージごとに返信を下書きし、下書きをルームに投稿し、人が「送って」と返信したときだけ送る、という指示です。ルームにいる全員が、下書きと承認を見られます。
curl -X POST https://makehybrid.com/whatsapp/v1/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"to":"+15551234567","text":"Your order is on its way."}'
メッセージは 10〜20 秒おきに送られるため、返信が届くまでそれだけかかることがあります。書き込んできた人、またはあなたからの連絡を待っている人に書き、同じ文面を大勢に送ることは決してしないでください。
よくある質問
エージェントは承認なしで送れますか？
指示にそう書いてあれば送れます。API はそれを止めません。お客様が読むものについては、ルームで「送って」を求めるのが、より安全な既定です。
お客様が送ってきた画像を読めますか？
メッセージにメディアが付いていたことは分かりますが、ファイルは見えません。お客様に内容を説明してもらうか、スマートフォンから返信してください。