リンクした WhatsApp 番号とは、スマートフォンで使っている普通の WhatsApp アカウント(自分のチャットとグループがあるもの)を、WhatsApp Web をブラウザーにリンクするのと同じ方法で MakeHybrid にもリンクしたものです。アカウントの本体は、あくまでスマートフォンのままです。リンクによって、API がその番号のチャットを読み、その番号として書き込めるようになります。
リンクのしかた
API にリンクを発行してもらい、コンピューターで開いて、表示される QR コードをスマートフォンでスキャンします。WhatsApp の「設定」、「リンク済みのデバイス」、「デバイスをリンク」の順です。リンクの有効時間は 1 時間で、開いているあいだはコードが更新され続けます。スキャンが済むと、接続が番号とその名前を返します。
curl -X POST https://makehybrid.com/whatsapp/v1/connection/link \ -H "X-API-KEY: $MAKEHYBRID_KEY"
できることと、できないこと
- 電話番号を指定して人に、またはチャット ID を指定してチャットやグループに、テキストを送る。
- チャットの一覧を、各チャットの最後のメッセージと未読数付きで読み、チャットのメッセージを読む。
- 受信したメッセージも送信したメッセージも、署名付きの Webhook イベントとして受け取る。
- ファイルは運べない：画像やドキュメントはメディアとして印が付くだけで、ファイル自体はスマートフォンに残る。
メッセージは 10〜20 秒おきに送られます。人が入力する速さです。WhatsApp は機械のように送る番号を制限するため、このペースが、リンクした番号がリンクされたままでいられる理由です。
よくある質問
スマートフォンの電源が切れていたらどうなりますか？
番号を必要とする呼び出しは、スマートフォンで WhatsApp をもう一度開くまで 409 not_online を返します。WhatsApp は、スマートフォンを 2 週間ほど使わないとデバイスのリンクを解除します。同じ方法でもう一度リンクしてください。
プロジェクトルームの WhatsApp チャネルと同じ番号ですか？
はい。どちらで番号をリンクしても、両方で使えます。片方でリンクを解除すると、両方で解除されます。