MessageBird を使用してメッセージを送信する

この拡張機能の動作

この拡張機能を使用すると、オムニチャネル メッセージ（SMS、WhatsApp、Google のビジネス メッセージ、Messenger、Telegram、Line、Viber など）を MessageBirdで送信できます。 ドキュメントが特定の Firestore コレクションに追加されると、この拡張機能は MessageBird Conversations API を使用してそのドキュメントをメッセージに変換し、ドキュメントの配信ステータスを更新します。

 db.collection('YOUR_DOCUMENT_COLLECTION').add({
  channelId: 'YOUR_CHANNEL_ID',
  type: 'text',
  content: {
    text: 'YOUR_MESSAGE_CONTENT'
  },
  to: 'RECIPIENT_OF_THE_MESSAGE',
});

注: サポートされているメッセージ タイプと必須のコンテンツ フィールドの完全なリストは Conversations API のドキュメント にあります。

追加の設定

この拡張機能をインストールする前に、Firebase プロジェクトで以下の Firebase サービスを設定してください。

• Cloud Firestore: メッセージ ドキュメントを保存します。
• ドキュメント内の手順に沿って、Cloud Firestore データベースを作成します。 この拡張機能をインストールする前に、MessageBird アカウントと MessageBird API アクセスキーを用意しておく必要があります。 また、メッセージを送信するときにチャネルを指定する必要があるため、メッセージの送出に使用する適切なチャネル（SMS チャネル、WhatsApp チャネル、Facebook Messenger チャネル、Telegram チャネルなど）を作成する必要もあります。

段階的な MessageBird アカウント設定

• MessageBird アカウントを MessageBird ページで作成し、要求されたら、"APIs" パスを選択します
• アカウントが作成されたら、API キーをダッシュボードとデベロッパーの設定ページのどちらかで表示できます。

チャネルページで、使用するチャネルを設定できます

• SMS の場合は、送信番号を取得する必要があります
• WhatsApp の場合は、WhatsApp インストール ウィザードに従ってビジネス アカウント用の WhatsApp を作成する必要があります。また、セッション外 WhatsApp メッセージを送信する場合は、WhatsApp メッセージ テンプレートを作成する必要が生じることがあります。
• その他のチャンネルの場合は、チャネルページ上の手順に沿ってください。

注: MessageBird には、実際のメッセージを送信せずに API を呼び出すことが可能なテストモードもあります。これをテスト目的で使用すると、開発中の余分な費用を抑えることができます。

料金

この拡張機能は、関連する料金が発生する可能性のある以下の Firebase サービスを使用します。

• Cloud Firestore
• Cloud Functions

この拡張機能は、以下のサードパーティ サービスも使用します。

• MessageBird Billing（価格情報)

お客様には、これらのサービスの使用に関連するすべての費用に対する責任があります。

Firebase に関する注意

この拡張機能をインストールするには、Firebase プロジェクトを Blaze（従量課金制）プランに含める必要があります。使用したリソース分のみが請求されます。ほとんどの Firebase サービスで、少量の使用のための無料枠が用意されています。Firebase の料金に関する詳細を確認してください。

この拡張機能をインストールまたは再構成すると、小額（通常は $0.10 未満）が課金されます。詳細な説明については、Firebase の料金 で Cloud Functions を参照してください。