Vonage APIを使ってSalesforceでSMSとWhatsAppメッセージを送る

Vonageは、以下でご紹介するオープンソースのコネクタやLightningコンポーネントと同じ機能を持つ「Conversations for Salesforce」製品をリリースする予定です。この製品は、Salesforce内で双方向のテキストおよびWhatsAppメッセージを提供するもので、現在アーリーアクセスのお客様にご利用いただけます！数分でSalesforceを使い始めたい方は、リリース前にアーリーアクセスプログラムにご参加ください。.

以下のチュートリアルでは、オープンソースのコネクターとLightningコンポーネントが提供する機能の構築方法について説明します。.

はじめに

このチュートリアルでは、VonageのオープンソースコネクタとLightningコンポーネントをインストールし、Salesforceから直接プッシュ通知を送信したり、SMSやWhatsAppの双方向メッセージングを実行できるようにします！

Salesforce、Node.js、Apex、JavaScript、そして Vonage Messages APIを使用します。.

オープンソースのコンポーネントは、以下のGitHubリポジトリにある：

• Node.jsコネクタ

• ライトニング・ウェブ・コンポーネント

ここでその様子を見ることができる：

セールスフォース組織の設定

このチュートリアルをお読みの方は、Salesforceを初めてお使いになる方ではありません。

• このパッケージをインストールするには、組織のシステム管理者である必要があります。

• これを本番環境に直接インストールする前に、サンドボックス環境にデプロイしてみてはどうだろう？開発者アカウントと呼ばれるもので、ここで好きなだけ取得できます： 開発者サインアップ.

オンボーディングフローを完了する頃には、Salesforce の開発者用インスタンスが作成され、何も壊すことなく好きなことができるようになります！

Salesforce内部で連携アプリを作成する

1. Salesforce Orgに接続したら、右上の「Setup」に進みます！

2. ⚙️ 左側のメニューでApp Managerを検索する。

1. 次に「New Connected App」をクリックする。

New Connected App

1. スクリーンショットに従って接続アプリを作成し、「OAuth設定を有効にする」にチェックを入れます。

App Manager Setup View

1. APIセクションの下に、ローカルのウェブフックにコールバックURLを追加し（このケースでは使用されません）、"Selected OAuth Scopes "の下で "Full Access "を選択します。

Enable Oauth settings

1. 次のページで「Continue」をクリックすると、「Consumer Key」と「Consumer Secret」が表示されます。この2つは、後の統合に備えて保管しておいてください。

Salesforce アンマネージドパッケージのインストール

オプション1：リンクからインストールする

1. Lightningウェブコンポーネントの LightningウェブコンポーネントのGitHubリンクにアクセスしてください。一番上に「アンマネージドパッケージをインストールする」というリンクがあります。GitHubの最初の段落にあるリンクが最新バージョンに更新されますので、そちらをご利用ください。

2. リンクをクリックしてパッケージをインストールします。完了すると、インストールされたアプリケーションのページに移動します：

Installed packages

オプション2：GitHub経由でインストールする

1. ダウンロード LightningウェブコンポーネントをGitHubをインストールし Salesforce CLIをインストールし、指示に従ってください。

続行するには、パッケージをインストールし、コンシューマー・キーとコンシューマー・シークレットが必要です。

Salesforce Node.Js コネクタのデプロイ

Salesforce 内で SMS と WhatsApp の双方向通信を行うには、Vonage API からの受信メッセージを受信し、カスタムオブジェクト経由で Salesforce 組織に送信するための Webhook を作成する必要があります。私たちがお手伝いします。

のコードをダウンロードする必要があります。 Node.jsコネクターからコードをダウンロードし、お気に入りのNode.js環境にデプロイする必要があります：Heroku、AWS Lambdaなど。

コードをデプロイする前に、JavaScript コネクタ用の正しい環境変数を提供する必要があります。この Node.js スクリプトが Salesforce API を呼び出せるように、Salesforce の API 認証情報を取得する必要があります。

手順に従ってください：

1. コネクテッドアプリの設定を取得します：先にこの手順を行いました。CONSUMER KEYとCONSUMER SECRETを以下の環境変数に保存してください。 詳細はこちら

• sfdc_consumer_key

• sfdc_consumer_secret

1. 専用の Salesforce ユーザーを作成します（または既存のユーザーを再利用します）： 詳細はこちら.

上記のステップで、ユーザーを作成した後、そのユーザーのユーザー名とパスワードを以下の環境変数に保存することができます：

• SFDC_USERNAME

• SFDC_PASSWORD

Vonage API Applications内でWebhookをセットアップする際に必要になりますので、サービスをホストしているURLを保存してください。2つのURLが公開されます：

• インバウンドURL：https://yourNodeServer/webhook/inbound

• イベントURL：https://yourNodeServer/webhook/event

Vonage APIダッシュボードの設定

Vonage API アカウントをお持ちでない場合は、次のページにアクセスしてください。 サインアップページまたは直接 ダッシュボード.

あなたは3つのことを実行する必要がある：

1. APIキーとシークレットの取得：アカウント作成後すぐに、ダッシュボードの ダッシュボード.

2. アプリケーションを作成し、ウェブフックを設定します：APIキーの下にアプリケーションを作成する。 ダッシュボードの Applications ページにある.

公開鍵と秘密鍵を生成する（これらは使用しない）。Capabilities]で[Messages]を有効にし、前のNode.jsのステップで作成した2つのコールバックURLを挿入します。

1. SMS/WhatsApp電話番号の関連付け、またはWhatsAppサンドボックスのご利用: WhatsAppまたはSMSの電話番号のご購入が必要です。電話番号は Numbersページ.

WhatsApp番号も簡単に作成できます。 埋め込みサインアップ機能.

それ以外の場合、WhatsApp Sandboxをすぐにご利用いただけます。 サンドボックスページ.

この時点で、受信メッセージはノードコネクタを直接トリガーし、Salesforceに直接プッシュされるはずです！ほぼ完了です！

Salesforce 内での Vonage 資格情報の設定

Vonageからのインバウンドメッセージが機能するようになったところで、アウトバウンドの設定を見てみよう。パッケージがインストールされているので、Vonageの認証情報に対する特定の設定が見つかります。

1. 前回同様、セットアップセクション（左上のメニュー）に入る。

2. 次に「カスタム設定」を探す。

1. Vonage API Configuration」と呼ばれるものがあります。

1. 管理」をクリックし、上部にある「新規」をクリックして認証情報を追加します。

1. すべてのフィールドを適切に入力します。WhatsAppサンドボックスを使用している場合、「USE_SANDBOX_FOR_MESSAGES_API」にチェックを入れ、「WHATSAPP_LVN」を「14157386102」と入力します。

2. 保存する

ライトニング・コンポーネントを配置する場所を決める

ここで、Lightningコンポーネントをインストールする位置を決めることができます。

では、ケースにどのように追加するか見てみよう。

1. サービスコンソールにアクセスし、既存のオープンケースを表示してケースを開きます。

2. 右上のメニューの歯車をクリックし、「ページの編集」を選択します。

1. フィード」と「関連」の隣に新しいタブを作成しよう 中央のウィンドウを選択する。

1. タブの追加」をクリックし、「カスタム」を選択して名前を変更する。

1. 左側のカスタムライトニングコンポーネントの下を見てください。コンポーネントをドラッグ＆ドロップして VonageMessagingコンポーネントをページの右側にドラッグ＆ドロップします。

これで完了です。これでどのケースからでもメッセージを送受信できるようになりました。

ボーナス：プロセスビルダーとフローを使用して、送信通知を自動化することもできます。

Salesforceから直接メッセージを自動化する必要がある場合は、SMSやWhatsAppメッセージの送信に統合を使用できます。

1. セットアップ」から「プロセス・ビルダー」を検索する。

2. 新規作成」をクリックして、新しいプロセスを作成する。

3. オブジェクトや条件を使ってプロセスを構築し、「即時アクション」ではスクリーンショットのようにSMSやWhatsAppメッセージを送信することができます。

4. Apexを選択し、次に'Send Vonage Message'を選択します。

次はどうする？

SMSとWhatsAppがSalesforceに統合されたことで、チームはService CloudやSales Cloud内でB2Cコミュニケーションのすべてを実行し、すべてのデータを一箇所に保管することができます。本格的な製品としてさらに多くの機能を追加する予定ですので、ご期待ください。