アプリを連携する

連携ページでは、Ringhumをチームがすでに使っているツールとつなぐことができます。アプリを連携すると、Ringhumは発生した通話、メッセージ、予約、注文をそのアプリに送信します。カレンダーの予定やショップの注文履歴など、情報を逆方向に取り込むアプリもあります。各アプリはワークスペースごとに1度連携すれば、そのワークスペースのすべてのアシスタントで利用できます。

始める前に

• アプリの連携・変更・解除ができるのは、ワークスペースのオーナーと管理者のみです。メンバーと閲覧者はページを見ることはできますが、カードにはこのアプリの連携は管理者に依頼してくださいと表示されます。
• ほとんどのアプリはすべてのプランで利用できます。Google Calendar(双方向同期)とCalendlyはTeamおよびScaleプランの機能です。それ以外のプランでは、カードに接続の代わりにプランロックが表示されます。
• 連携先のアプリのアカウントが必要で、通常はAPIキーやWebhookを作成できる管理者権限も必要です。

アプリカタログ

サイドバーの連携を開きます。検索欄やカテゴリーボタンを使ってアプリを探せます。接続済みボタンをクリックすると、すでに連携したアプリのみが表示されます。

お使いのツールが一覧にない場合も、多くはZapier、Make、n8n経由、または開発者にある独自のWebhookエンドポイントで連携できます。ページ上部のWebhookと APIボタンからアクセスできます。

3つの連携方式

各アプリは、次の3つの連携方式のいずれかを使用します。カードと連携ダイアログに、どの方式かが表示されます。

2つのグループは動作が異なります。カレンダーフィード(ICS)カードでは、カレンダーアプリに貼り付けるリンクが得られるだけで、何かを連携するわけではありません。ホテル向けチャネル(Booking.com、Airbnb、Vrbo)は部屋ごとに設定します。それぞれのカードには部屋設定で設定ボタンがあり、部屋と料金が開きます。

APIキーまたはWebhook URLでアプリを連携する

1. 連携を開き、対象のアプリを見つけます。
2. カードの接続をクリックします。接続ダイアログが開き、相手のアプリでの認証情報の取得場所が簡単に説明されます。多くのアプリにはドキュメントへのリンクもあります。
3. APIキー、サブドメイン、リストID、プロジェクトID、Webhook URLなど、必要な項目を入力します。
4. 送信で、そのアプリに送るイベントにチェックを入れます。詳しくは送信する内容を選ぶをご覧ください。
5. ダイアログに対応が必要な通話のみのスイッチが表示されている場合は、すべての通話を送るか、対応が必要な通話のみを送るかを選びます。
6. 接続をクリックします。

Ringhumは、何かを保存する前に接続を確認します。確認に失敗した場合は何も保存されず、ダイアログには接続できませんでしたと、相手のアプリから返された理由(拒否されたキーなど)が表示されます。項目を修正して再度お試しください。

注: 認証情報は暗号化して保存され、当社のサーバーからのみ使用されます。

サインインでアプリを連携する

1. カードの接続をクリックします。相手のサービスに移動します。
2. サインインし、要求されたアクセス権を承認します。
3. 連携ページに戻り、確認メッセージが表示されます。

サインイン方式の一部のアプリでは、もう1つ手順が必要です。Google Sheetsの場合、カードの設定をクリックし、スプレッドシートIDを貼り付けます。設定するまでは、配信は「連携設定でスプレッドシートIDを追加してください」というメッセージとともにスキップされます。Google Driveはすぐに使い始められ、設定でフォルダIDを追加しない限り「マイドライブ」にファイルが保存されます。

接続をテストする

連携済みのカードには、接続済み、エラー、一時停止中のいずれかのステータスバッジが表示されます。最終配信の時刻と、そのアプリが受け取るイベントも表示されます。

• テストを送信(メッセージング・自動化アプリ向け):テストメッセージを投稿し、チャンネルやワークフローに届く様子を確認できます。
• テスト(その他すべてのアプリ向け):認証情報が引き続き有効かを確認します。

結果は画面上部にメッセージとして表示されます。ZapierやMakeの場合は、フィールドをマッピングする前にテストイベントを送信すると、ワークフローがデータ構造を学習できます。

連携を管理する

連携済みのカードには、次のボタンの一部またはすべてが表示されます。

• 設定(入力項目のあるアプリ):ダイアログを再度開き、認証情報やイベントを変更できます。設定を保存をクリックしてください。変更を保存する前に、接続が再度確認されます。
• 再接続(サインイン方式のアプリ):パスワードを変更した後やアクセス権が失効した後など、サインインをやり直します。
• 一時停止:設定を保持したまま、すべての配信を停止します。再開で再び配信を開始します。
• 接続を解除:連携と保存済みの認証情報を削除します。

トラブルシューティング

「接続」ボタンが表示されない。 オーナーまたは管理者ではない可能性があります。そのアプリにより上位のプランが必要な場合はカードにプランロックが表示されます。サインイン方式のアプリで設定が必要ですと表示される場合、現在利用できない状態です。このバッジが表示され続ける場合はサポートにお問い合わせください。

「このワークスペースではネイティブ連携が無効になっています」というバナーが表示される。 CRM、ヘルプデスク、タスク管理、スプレッドシート、マーケティング、分析、Eコマース系のアプリがワークスペースで無効になっています。メッセージング、自動化、カレンダー系のアプリは引き続き利用できます。再度有効にするにはサポートにお問い合わせください。

テスト通話がSlackやCRMに表示されない。 テスト通話による通話の更新、受信トレイの項目、注文は連携アプリに送信されません。実際にその番号へ発信してください。

カードに「エラー」と表示される。 カードの最終配信の行をクリックすると、問題の内容を確認できます。詳しくは配信のトラブルシューティングをご覧ください。