チャンネル:Telegram、WhatsApp、VK
Telegram、WhatsApp、VK を 1 つのプロジェクトに接続します。チャンネルごとの機能と、ボットの返信先を説明します。
このページの内容
1 つの GetMyBot プロジェクトで Telegram、WhatsApp、VK に返信できます。たとえば授業の時間割を知らせるリアクションを 3 つのアプリで共用できます。返信は相手がメッセージを送ったアプリに戻ります。
別のアプリを接続するときは、ボタンとアクションを確認してください。利用できる機能はアプリごとに異なります。以下で違いと接続手順を説明します。
チャンネルとは
チャンネルは、メッセージを送受信する接続先です。具体的には Telegram ボット、WhatsApp Business の番号、VK コミュニティなどです。1 つの GetMyBot ボットに複数のチャンネルを接続できます。リアクションは共通です。登録者が WhatsApp から書いた場合も Telegram と同じリアクションが処理し、返信は WhatsApp に送られます。
ボタン、書式、アクションはアプリ間で同じではありません。エディターは未対応の設定を隠したり、利用できる形式に変換したりします。公開前に、接続した各チャンネルでメッセージを試してください。
メインチャンネル(primary_channel)
各ボットにはメインチャンネル(primary_channel)があります。主にそのボットと結び付くアプリです。通常は Telegram ですが、Telegram なしで最初から WhatsApp または VK のボットを作ることもできます。メインチャンネルは作成時に決まり、ボット一覧に表示されます。ほかのチャンネルは後から追加します。
チャンネルの機能
以下は各チャンネルで使える機能の概要です。プログラムで読める最新の一覧は API の GET /api/channels/capabilities で取得できます。
Telegram: 対応機能が最も豊富です。メッセージ内のボタンと返信用キーボード、ボタン操作からリアクションを始める callback、絵文字リアクション、/start のディープリンク、メッセージの編集・削除・転送、返信をトリガーにする機能、メンバーイベント、権限とモデレーションに対応します。写真のファイル ID がそろっている場合、写真カルーセルは 1 つのメッセージ内でボタンを使って切り替わります。テキスト形式は Plain / HTML / Markdown です。WhatsApp のテンプレート、リスト、24 時間のセッション枠は Telegram にはありません。
WhatsApp(WhatsApp Cloud API 経由):メッセージ内のボタン、callback、絵文字リアクション、/start ディープリンクに加え、メッセージテンプレート、対話型リスト(interactive list)、24 時間のセッション枠があります。テキスト形式は Plain / Markdown です。返信用キーボード、メッセージの編集・削除・転送、返信をトリガーにする機能、メンバーイベント、権限とモデレーション、1 つのメッセージ内でのカルーセル切り替えには対応しません。詳しくはWhatsAppをご覧ください。
VK: メッセージと添付ファイル、メッセージ内のボタンと返信用キーボード、callback、絵文字リアクション、/start ディープリンク、メッセージの編集・削除・転送、メンバーイベント、ブロックと解除、非公開コミュニティへの提出済みの参加リクエストの承認、有料会員機能 VK Donut のイベントに対応します。テキストはプレーンテキストのみで、HTML/Markdown は表示時に取り除かれます。WhatsApp のテンプレートやリスト、1 つのメッセージ内でのカルーセル切り替え、セッション枠はありません。
すべてのチャンネルで、メッセージ内のボタン、callback、絵文字リアクション、/start ディープリンクを使えます。写真に対応するチャンネルでは写真カルーセルのブロックも使えます。Telegram では、すべての写真に利用可能な file_id がある場合だけ、カードが 1 つのメッセージ内で切り替わります。WhatsApp と VK、または写真 1 枚でも適切な ID を取得できなかった Telegram では、すべてのカードが写真メッセージとして個別に送られます。各カードの説明文とボタンは保持されます。メッセージとボタンもご覧ください。
VK Donut
コミュニティで VK Donut を有効にすると、有料会員に関する次のシステムイベントがボットに届きます。
| エディター上のイベント | キー | 利用できる値 |
|---|---|---|
| VK Donut: subscription created(入会) | donut_subscription_created | {{event.donut_amount}}、{{event.donut_amount_without_fee}} |
| VK Donut: subscription prolonged(更新) | donut_subscription_prolonged | {{event.donut_amount}}、{{event.donut_amount_without_fee}} |
| VK Donut: subscription expired(期限切れ) | donut_subscription_expired | なし |
| VK Donut: subscription cancelled(解約) | donut_subscription_cancelled | なし |
{{event.donut_amount}} は支払額、{{event.donut_amount_without_fee}} は VK の手数料を除いた額です。期限切れや解約のイベントに金額はありません。支払い済み期間の終了は新たな支払いではなく、過去の支払額をここに表示すると誤解を招きます。
これは登録者に関するイベントであり、登録者からのメッセージではありません。そのため、個別メッセージを送れる状態にはならず、ブロックの解除、「最終アクティビティ」の更新、メッセージ数の増加も起きません。カードからの引き落としは、その人が書き込んだことを意味しません。まだ登録者の記録がなければ、ラベルや権限を設定できるよう記録が作られます。
有料コミュニティの設定例:
- VK Donut: subscription created と VK Donut: subscription prolonged に対するリアクションを作ります。ラベルを変更で「クラブ」ラベルを
ttl_days= 31 日間付け、非公開コミュニティのリンクを送って参加リクエストを出してもらいます。 - 参加リクエストが提出されてから承認します。 権限を変更 → 参加リクエストを承認が受け付けるのは、すでに提出済みのリクエストだけです(
groups.approveRequest)。まだリクエストがなければ承認できません。ステップ 1 の後に動くリアクションに配置してください。たとえば同じメッセージの「申請しました」ボタン、または次回の VK Donut: subscription prolonged イベントです。 - Label expired(
label_expired)に対するリアクションに、権限を変更 → 退出させるを追加します。VK から期限切れイベントが届かなくても、ラベルの期間が終われば退会させられます。詳しくはトリガー → ラベルの期限切れをご覧ください。 - VK Donut: subscription cancelled と VK Donut: subscription expired には、ラベルを変更 → 「クラブ」を削除を設定し、必要ならすぐに退出させるも実行します。
VK の権限アクションのチャット(chat_id)には、接続したコミュニティの数値 ID を指定してください。チャンネル一覧の VK チャンネルに表示される番号と同じものです。そのチャンネルで操作できるのは、このコミュニティのメンバーだけです。別の ID は VK に送る前に拒否されます。ほかのコミュニティを管理するには、別のチャンネルとして接続してください。
イベントを有効にする方法:
- Long Poll: チャンネル接続時とプラットフォームの起動時に、ボットが自動でイベントを購読します。すでに接続済みのコミュニティで追加作業は不要です。
- Callback API: コミュニティの設定で API の利用 → Callback API → イベントの種類 → VK Donut を開き、表の 4 イベントすべてを有効にします。
チャンネルを接続する
チャンネルはプロジェクトから追加します。
- プロジェクトを開き、対象のプロジェクトを探します。
- プロジェクトカードのチャンネルを追加を押します。
- Telegram、WhatsApp、VK から選びます。
- 接続情報を入力します。Telegram はトークン、WhatsApp は Meta の情報、VK はコミュニティ情報が必要です。
- 確認を押し、サービス側で情報を検証します。
- 接続を押します。
WhatsApp と VK では、接続後にチャンネルのwebhook アドレスが 🔗 アイコンとともに表示されます。受信イベントをボットに届けるため、そのアドレスを WhatsApp なら Meta アプリ、VK ならコミュニティの設定に登録してください。WhatsApp の手順はwebhook の設定をご覧ください。
次のステップ
- WhatsApp:接続、webhook、セッション枠、メッセージテンプレート。
- プロジェクトとチャンネル:ボット接続の基本。
- リアクションの基本:すべてのチャンネルで共用する動作。
チャンネルの認証情報
Telegram には BotFather の完全なトークンが必要です。VK にはコミュニティトークンと数値のコミュニティ ID が必要で、Callback API を使う場合は秘密文字列と確認コードも必要です。WhatsApp には Phone Number ID、WhatsApp Business Account ID、アカウントのアクセストークン、webhook の Verify Token、Meta アプリの App Secret を入力してください。
接続前に内容を確認してください。キーを変更した場合は、提供元の関連設定も更新します。Verify Token は webhook アドレスの確認に、App Secret は受信イベントの署名確認に使います。どちらも API アクセストークンの代わりにはなりません。
受信イベントと webhook アドレス
VK Callback API を使う場合は、MyBot に表示されたアドレスをコミュニティのサーバー設定に登録し、秘密文字列と確認コードを両側で一致させます。Long Poll には公開アドレスもこの 2 つの値も不要です。WhatsApp では Meta アプリにアドレスを登録し、同じ Verify Token を入力して、必要なメッセージイベントを購読します。送信側の認証情報を設定するだけでは受信は始まりません。
Instagram と Messenger の認証
接続ウィザードから Meta の認証画面を開きます。対象の Facebook ページまたはプロアカウントの Instagram を管理するアカウントでログインし、必要な権限を許可して、このプロジェクトで使うアカウントを選びます。ウィザードは権限、webhook の購読、配信の準備状況を確認します。失敗した項目はチャンネルを使う前に解決してください。既存の接続でも選択済みのアカウントを後から見直せます。