Twilioとの統合
タブ
PlatoFormsは、フォームのためにテキストメッセージ(SMS)を送信できます:送信通知、招待状、ドキュメントリクエスト、更新およびワークフロータスク。デフォルトでは、PlatoForms SMSを通じて送信され、クレジット残高から支払われ、固定されたテキストを使用します。Twilioアカウントをお持ちの場合は、それを接続して、これらのテキストをあなた自身のTwilioを通じて送信することができます。
PlatoForms SMSまたはあなた自身のTwilio
| PlatoForms SMS | あなた自身のTwilio | |
|---|---|---|
| 送信者 | PlatoFormsの送信者 | あなたのTwilioメッセージングサービス:あなたの電話番号または送信者ID |
| コスト | PlatoFormsのクレジット残高から支払われる | Twilioによってあなたのアカウントに請求される。PlatoFormsのクレジットは使用されない |
| 対応国 | PlatoForms SMSがサポートする国 | あなたのTwilioアカウントがメッセージを送信できる国 |
| メッセージテキスト | PlatoFormsによって固定される | 受取人の名前やリンクなどの変数を使ってあなたが書く |
| 新しいアカウントの承認 | 一度の承認 | 必要なし |
Twilioアカウントがない?必要ありません:PlatoForms SMSは、設定なしでテキストを送信し、米国またはカナダのビジネスはそこで米国の番号にメッセージを送信するために登録できます。テキストメッセージ(SMS)を送信するを参照してください。これらのサービスは別々です:PlatoFormsに登録しても、Twilioアカウントが送信できるものは変わりません。
Twilioをチームのために一度接続します。その後、テキストを送信する各場所でサービスを選択するので、1つのフォームはあなたのTwilioを使用し、別のフォームはPlatoForms SMSにとどまることができます。
テキストメッセージングには有料プランが必要です。Twilioの接続は、チームオーナーまたは請求アクセスを持つメンバーによって行われます。フォームの統合ページでTwilioカードが表示されない場合、その機能はまだチームに対して有効化されていません:お問い合わせください。
開始前に:Twilioから必要なもの
これらをTwilioコンソールで収集してください:
-
送信者を持つメッセージングサービス。 Messaging > Servicesに移動し、サービスを開くか作成し、電話番号またはアルファベット送信者IDを送信者プールに追加します。メッセージングサービスSID(
MGで始まる)をコピーします。 -
あなたのアカウントSID(
ACで始まる)、アカウント情報の下に表示されます。 -
標準APIキー。 Account > API keys & tokensに移動し、Standardキーを作成し、そのSID(
SKで始まる)とそのシークレットをコピーします。Twilioはシークレットを一度だけ表示します。リージョンセレクタをデフォルトの**United States (US1)**のままにしておいてください。リージョンはメッセージを送信できる国を制限しません。
APIキーを使用し、TwilioのAuth Tokenを使用しないでください。APIキーは他のTwilioアカウントに影響を与えずに単独で取り消すことができます。
米国の番号にメッセージを送信するには、Twilioはメッセージングサービスに登録されたA2P 10DLCキャンペーンまたは検証済みのフリーダイヤル番号を持っている必要があります。他の国にはそれぞれの送信者ルールがあり、多くはアルファベット送信者IDを受け入れます。メッセージを送信する国のTwilioのガイドラインを確認してください。
Twilioアカウントを接続する
-
ダッシュボードで、任意のフォームにカーソルを合わせ、右上の設定(ギアアイコン)をクリックし、次にフォーム管理をクリックします。
-
左のサイドバーで統合をクリックします。
-
Twilioカードを見つけて接続をクリックします。テキストメッセージングページが新しいブラウザタブで開き、あなた自身のTwilioタブが表示されます。
Note接続はチーム全体のためのもので、任意のフォームから一度行います。また、プランと請求 > クレジット残高からページを開くこともできます:SMSメッセージの横にあるテキストメッセージング設定をクリックし、次にあなた自身のTwilioタブをクリックします。
-
Twilioを接続するの下で、アカウントSID、メッセージングサービスSID、APIキーSID、APIキーシークレットを入力し、接続をクリックします。
PlatoFormsはこれらの資格情報でアカウント、メッセージングサービスおよびその送信者を確認します。何も送信されません。APIキーシークレットは暗号化されて保存されます。
-
チェックが通過すると、あなた自身のTwilioが接続済みと表示され、メッセージングサービスの番号または送信者IDが表示されます。
-
(オプション)テストテキストを送信するの下で携帯番号を入力し、テストテキストを送信をクリックして配信を確認します。Twilioはこのテキストに対して請求します。
フォームのテキストにTwilioを使用する
Twilioを接続してもそれ自体では何も変わりません。各SMSセクションは切り替えるまでPlatoForms SMSを使用し続けます。
-
変更したいSMS設定を開きます。例えばフォーム管理 > 招待状またはフォーム管理 > 通知を開き、SMSをオンにします。
-
あなた自身のTwilioを選択します。
-
テキストメッセージを書きます。挿入の横にある変数をクリックして追加します。電話に表示される内容はサンプル値でメッセージをプレビューし、その長さと送信されるテキストの数を示します。
-
変更を保存します。
これらの場所でこの選択を行うことができます:
| 場所 | どのテキスト |
|---|---|
| 通知 | フォームが送信されたときに送信されるテキスト |
| 招待状 | 招待状とそのリマインダー |
| ドキュメントリクエスト | ドキュメントリンク、リマインダー、新しいアップロードのリクエスト |
| 更新 | 更新通知 |
| ワークフローステップ通知 | ワークフロータスクのために送信されるテキスト |
独自のテキストのルール
- テキストは最大320文字までです。長いメッセージは複数のテキストとして送信されます。プレビューはその数を示します。
- そのテキストに提供される変数のみを使用してください。リンクを配信するテキスト(招待状、ドキュメントリクエスト、更新およびワークフロータスク)には
{{ link }}が含まれている必要があります。 - PlatoFormsはすべてのテキストにオプトアウト行を追加します:送信者が電話番号の場合は「返信STOPでオプトアウト」、アルファベット送信者IDの場合はオプトアウトリンク(返信を受け取れない)。メッセージングサービスに両方がある場合、Twilioは国が許可する限りアルファベット送信者IDを使用するため、それらのテキストはオプトアウトリンクで終わります。
- テキストは保存時にチェックされます。パスワード、支払い情報、個人情報を要求するテキストは受け入れられません。
- あなたからのテキストを受け取ることに同意した人にのみテキストを送信してください。受信者およびフォームごとの日次制限は、テキストを受け取る人を保護するために適用されます。
| 変数 | 挿入内容 | 使用可能な場所 |
|---|---|---|
{{ team }} |
あなたのチーム名 | すべてのテキスト |
{{ form }} |
フォーム名 | すべてのテキスト |
{{ name }} |
受取人の名前 | 招待状 |
{{ link }} |
受取人が開くリンク | 招待状、ドキュメントリクエスト、更新、ワークフローステップ |
{{ workflow }}, {{ step }} |
ワークフロー名とステップ名 | ワークフローステップ |
{{ item }}, {{ expires }} |
ドキュメント名とその期限日 | 更新 |
請求と使用
- あなたのTwilioを通じて送信されたテキストは、Twilioによってあなたのアカウントに請求されます。PlatoFormsはそれらに対して課金せず、クレジット残高も使用しません。
- それらは使用状況ページのSMSの下に$0.00で表示されます。
- PlatoForms SMSに残されたセクションは以前と同様に機能し、クレジット残高から支払われます。
APIキーの置き換えまたは切断
- キーを置き換える: Twilioで新しいAPIキーを作成し、テキストメッセージングページを開き(Twilioカードで設定をクリック)、Twilioを再接続するの下にキーを入力します。
- 切断: Twilioを切断するをクリックします。APIキーシークレットはPlatoFormsから削除されます。あなた自身のTwilioに設定されたセクションは標準テキストでPlatoForms SMSに戻ります。あなたの選択とテキストは保持され、再接続時に再び使用されます。
- 注意が必要: 例えばキーを取り消した後にTwilioがキーを受け入れなくなると、接続は注意が必要と表示され、チームオーナーにメールが届きます。再接続するまで、これらのセクションはPlatoForms SMSを使用し、クレジット残高が必要です。
トラブルシューティング
| 表示される内容 | 対処方法 |
|---|---|
| “このメッセージングサービスには送信者がいません。” | Twilioで、サービスの送信者プールに電話番号またはアルファベット送信者IDを追加し、再接続してください |
| 米国の番号へのテキストが配信されない | メッセージングサービスのためにA2P 10DLCキャンペーンを登録するか、検証済みのフリーダイヤル番号を使用してください |
| “まずTwilioアカウントを接続してください。” | テキストメッセージングページでTwilioを接続してからあなた自身のTwilioを選択してください |
| “このテキストは受け入れられませんでした。” | パスワード、支払い情報、個人情報を要求する表現を削除してください |
| あなた自身のTwilioに設定されたセクションがクレジット残高を使用する | あなたのTwilioが切断されているか、注意が必要です。あなた自身のTwilioタブで再接続してください |
| “このメッセージングサービスには登録された米国送信者がいません” | TwilioコンソールでA2P 10DLCキャンペーンを登録するか、フリーダイヤル番号を検証してください。PlatoForms SMSに登録してもこれを修正しません |