SmartDialog
SmartDialog は、SMS および WhatsApp メッセージの送受信に使用されるプラットフォームです。 さまざまなスマート メッセージング サービスを提供します。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Arena Interactive サポート |
| [URL] | https://www.arenainteractive.fi/contact |
| メール | support@arenainteractive.fi |
| Connector Metadata | |
|---|---|
| 発行者 | Arena Interactive Oy |
| Web サイト | https://www.arenainteractive.fi |
| プライバシー ポリシー | https://www.arenainteractive.fi/privacypolicy |
| カテゴリ | 通信; コラボレーション |
SmartDialog コネクタを使用すると、SmartDialog プラットフォームを介してメッセージを送受信できます。 メッセージには、SMS、MMS、および WhatsApp が含まれますが、これらに限定されません。
前提条件
- SmartDialog サブスクリプションとアカウント。 sales@arenainteractive.fi にお問い合わせください
- メッセージを受信するには、入力ソースも必要です。 これらは、国内ショートコード、国際ロングコード、または WhatsApp Business アカウントのようなインスタント メッセージング アカウントにすることができます。
資格情報の入手方法
sales@arenainteractive.fi に連絡し、Arena Interactive との契約に署名します。 アカウントを取得したら、一方向メッセージング サービスの作成に進みます。 受信メッセージも受信する場合は、アドレスと有効なキーワードを設定した双方向サービスも必要です。
コネクタの使用を開始する
アカウントを取得すると、Logic Apps、Power Automate、その他のサービスからのメッセージの送受信に進むことができます。 たとえば、連絡先が作成されたとき、または案件がクローズされたときに、Microsoft CRM から新しいメッセージをトリガーすることができます。
既知の問題と制限事項
メッセージの種類の選択に応じて、いくつかの制限が適用されます。 たとえば、SMS メッセージはメッセージごとに 140 バイトの情報を伝達することができます。 これを超えると、メッセージのチェーンが自動的に行われます。 チェーン ヘッダーは、各メッセージから一部のデータを消費することに注意してください。 一例として、標準の GSM アルファベットを使用すると、1 つのメッセージは 160 文字になりますが、2 つのメッセージはチェーンのために 306 文字のテキストしか伝達することができません。 メッセージはパーツ単位の請求になるため、前の例では 2 つの「パーツ」が必要になります。 Unicode を使用すると、各メッセージパーツが伝達できるテキストの量が約半分になります。
一般的なエラーと解決策
一般的なエラーには、認証エラーが含まれます。
- SmartDialog ユーザーが OAuth2 認証の実行を許可されていない可能性がある場合。
- 管理者または support@arenainteractive.fi に連絡し、有効にしてください。
- serviceId、または別の会社に属する serviceId を提供する可能性がある場合。
- ServiceId を確認します
よくあるご質問
- API 要求ではどの電話番号形式を使用する必要がありますか?
358207434242 のように、接頭辞 (+、00) を付けず、数字の間に余分な文字を入れない国際形式を使用することを強くお勧めします。 API は、フィンランドの呼び出しコード (358) を既定として使用して、数字の余分な部分を削除し、国内番号を国際形式に変換しようとしますが、入力と求められる結果によっては、このプロセスで必ずしも期待される結果が得られるとは限りません。
- 1 つの SMS にいくつの文字が収まりますか?
1 つの SMS は 140 バイトのデータを保持できます。 連結された (長い) メッセージを送信する場合、連結メソッドは各 SMS から 6 バイトを確保し、連結された各 SMS の残りのメッセージ データ用に 134 バイトを残します。 テキスト メッセージに GSM 03.38 文字セットを使用する場合、文字は 7 ビットのセプテットにパックされます。 140 バイト (1 つの SMS) はこれらのセプテットのうち 160 を保持でき、134 バイト (連結) は 153 を保持できます。 GSM 03.38 のほとんどの文字は、それぞれ 1 つのセプテットを使用しますが、いくつかの文字 (最も一般的に使用されるのはユーロ文字) には、それぞれ 2 つのセプテットが必要です。 GSM 文字セットの詳細: http://en.wikipedia.org/wiki/GSM_03.38 Unicode メッセージの場合、各文字は 2 バイトが必要です。 140 バイト (1 つの SMS) は 2 バイト シーケンスのうち 70 を保持でき、134 バイト (連結) は 67 を保持できます。 バイナリ メッセージの場合、スペース消費量はメッセージ タイプによって異なりますが、SMS あたり 140 バイトの上限がそれらにも適用されます。
- どのくらいの連結されたメッセージを送信できますか?
SMS の連結メカニズムでは、最大 255 の連結パーツを使用できますが、すべての受信デバイスがこのパーツ数を処理できるわけではありません。 3 つの SMS より長いテキスト メッセージや、4 つの SMS より長いバイナリ メッセージを送信することはお勧めしません。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
|
Whats |
送信者と受信者に対する WhatsApp オプトアウト。 (非推奨) |
|
Whats |
送信者と受信者に対する WhatsApp オプトイン。 (非推奨) |
|
Whats |
新しい WhatsApp テンプレートを作成する |
|
Whats |
WhatsApp テンプレートのメッセージを送信します。 |
| すべてのグループ連絡先を削除する |
すべてのグループ連絡先を削除する |
| グループ 連絡先を作成する |
グループ 連絡先を作成する |
| グループ連絡先の更新 |
グループ連絡先の更新 |
| グループ連絡先を削除する |
電話番号を使用してグループの連絡先を削除します。 |
| グループ連絡先を取得する |
グループ連絡先を取得する |
| ディスカッション返信メッセージを送信する |
ディスカッション返信メッセージを受信者に送信します。 |
| メッセージを送信する |
受信者にメッセージを送信します。 |
| 返信メッセージを送信する |
受信者に返信メッセージを送信します。 |
WhatsApp オプトアウト (非推奨) [非推奨]
送信者と受信者に対する WhatsApp オプトアウト。 (非推奨)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
送信者アドレス
|
Sender | True | string |
オプトアウトする元の登録済み Whatsapp ID 番号。 |
|
受信者アドレス
|
Recipient | True | string |
オプトインから削除する受信者番号。 |
WhatsApp オプトイン (非推奨) [非推奨]
送信者と受信者に対する WhatsApp オプトイン。 (非推奨)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
送信者アドレス
|
Sender | True | string |
オプトインする先の登録済み Whatsapp ID 番号。 |
|
受信者アドレス
|
Recipient | True | string |
オプトインする受信者番号。 |
WhatsApp テンプレートを作成する
新しい WhatsApp テンプレートを作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer-Id | True | string |
テンプレートを作成する対象の顧客。 |
|
IdentityNumber
|
IdentityNumber | True | string |
テンプレートに使用する WhatsApp IdentityNumber。 |
|
Displayname
|
DisplayName | True | string |
テンプレートの表示名。 |
|
コンテンツ
|
RawContent | True | string |
テンプレートのコンテンツ。 |
|
テンプレート カテゴリ
|
Category | True | string |
WhatsApp テンプレート カテゴリ。 |
|
テンプレート言語
|
Language | True | string |
テンプレート言語を表す 2 文字のコード。 |
|
ボタンの種類
|
Type | string |
ボタンの種類。 |
|
|
ボタンのラベル
|
Label | string |
ボタンのラベル。 |
|
|
ボタン データ
|
Data | string |
ボタン データ。 URL (URL)、電話番号 (Call)、またはテキスト (QuickReply)。 最大長は、URL の場合は 2000、電話番号とテキストの場合は 20 です。 |
|
|
添付ファイルの URL
|
AttachmentUrl | string |
サンプル添付ファイルの URL。 |
WhatsApp メッセージを送信する
WhatsApp テンプレートのメッセージを送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer-Id | True | string |
送信に使用する顧客。 |
|
サービス
|
Service-Id | True | string |
送信に使用するサービス。 |
|
WhatsApp テンプレート
|
TemplateName | True | string |
送信に使用するテンプレート。 |
|
番地
|
Address | True | string |
メッセージ受信者のアドレス。 |
|
BodyParameters
|
BodyParameters | array of string |
BodyParameters |
|
|
HeaderParameters
|
HeaderParameters | array of string |
HeaderParameters |
|
|
タイプ
|
Type | string |
ボタンの種類。 テンプレートごとに 1 つのタイプのみで、同じタイプを複数含めることができます。 |
|
|
テキスト
|
Data | string |
ボタンのテキスト。 |
|
|
送信日時
|
SendDateTime | string |
メッセージを送信する日時。 すぐに送信するには、空のままにします。 |
|
|
添付 URI
|
AttachmentUri | string |
テンプレートに添付ファイルが含まれている場合は、添付 URI。 |
|
|
SMS フォールバックを使用する
|
UseSmsFallback | boolean |
SMSをフォールバックとして使用する必要があります。 |
|
|
配信レポート URL
|
DlrUrl | string |
sendprocess が完了したときにコールバックを受信する配信レポートの URL。 |
|
|
顧客データ
|
CustomerData | string |
このメッセージの請求/グループ化データです (オプション)。 |
|
|
要求 ID
|
RequestId | string |
重複した要求を特定するために使用できるオプションの一意の要求 ID。 重複するリクエスト ID が検出された場合、送信はキャンセルされます。 スループット/トラフィックが高い状況で、重複するリクエスト ID を持つリクエストがブロックされるという保証はありません。 指定された requestId は 7 日間 "記憶" されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ Id
|
messageId | string |
新たに作成されたメッセージの識別子。 |
|
メッセージ部分数
|
messagePartCount | integer |
このメッセージのメッセージ パーツのおおよその数。 |
|
受信者
|
recipients | array of object |
受信者 |
|
受信者のアドレス
|
recipients.address | string |
受信者のアドレス (電話番号/電子メール/ユーザー ID など)。 |
|
受信者 ID
|
recipients.id | string |
配信状態に関する情報の受信に使用される受信者識別子。 |
すべてのグループ連絡先を削除する
すべてのグループ連絡先を削除する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer | True | string |
グループ サービスを取り込む顧客。 |
|
グループ サービス
|
Group Service | True | string |
使用するグループ サービス。 |
戻り値
- 返答
- boolean
グループ 連絡先を作成する
グループ 連絡先を作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer | True | string |
グループ サービスを取り込む顧客。 |
|
グループ サービス
|
Group Service | True | string |
使用するグループ サービス。 |
|
アクティブです
|
active | boolean |
連絡先がアクティブかどうかを示すフラグ。 |
|
|
電話番号
|
phone | True | string |
連絡先の電話番号。 |
|
メール
|
string |
連絡先の電子メール アドレス。 |
||
|
名
|
firstName | string |
連絡先の名前。 |
|
|
姓
|
lastName | string |
連絡先の苗字。 |
|
|
Gender
|
gender | string |
連絡先の性別。 |
|
|
誕生年
|
birthYear | integer |
連絡先の生年月日。 |
|
|
住所
|
streetAddress | string |
連絡先の住所の番地。 |
|
|
Zip Code
|
zipCode | string |
連絡先の郵便番号。 |
|
|
都市
|
city | string |
連絡先の所在市。 |
|
|
Country Code
|
countryCode | string |
連絡先の 3 文字の国コード。 |
|
|
件名
|
name | string |
カスタム プロパティ名。 |
|
|
価値
|
value | string |
カスタム プロパティ値。 |
|
|
電話番号の地域
|
phoneNumberRegions | array of string |
番号の解析に使用する電話番号の地域。 空のままにすると、デフォルトはフィンランドになります。 |
戻り値
作成された連絡先の一意の ID。
- 連絡先 ID
- uuid
グループ連絡先の更新
グループ連絡先の更新
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer | True | string |
グループ サービスを取り込む顧客。 |
|
グループ サービス
|
Group Service | True | string |
使用するグループ サービス。 |
|
電話番号
|
Phone | True | string |
更新する連絡先の電話番号。 |
|
アクティブです
|
active | boolean |
連絡先がアクティブかどうかを示すフラグ。 |
|
|
メール
|
string |
連絡先の電子メール アドレス。 |
||
|
名
|
firstName | string |
連絡先の名前。 |
|
|
姓
|
lastName | string |
連絡先の苗字。 |
|
|
Gender
|
gender | string |
連絡先の性別。 |
|
|
誕生年
|
birthYear | integer |
連絡先の生年月日。 |
|
|
住所
|
streetAddress | string |
連絡先の住所の番地。 |
|
|
Zip Code
|
zipCode | string |
連絡先の郵便番号。 |
|
|
都市
|
city | string |
連絡先の所在市。 |
|
|
Country Code
|
countryCode | string |
連絡先の 3 文字の国コード。 |
|
|
件名
|
name | string |
カスタム連絡先プロパティ名。 |
|
|
価値
|
value | string |
カスタム連絡先プロパティの値。 |
|
|
電話番号の地域
|
phoneNumberRegions | array of string |
番号の解析に使用する電話番号の地域。 空のままにすると、デフォルトはフィンランドになります。 |
戻り値
- 返答
- boolean
グループ連絡先を削除する
電話番号を使用してグループの連絡先を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer | True | string |
グループ サービスを取り込む顧客。 |
|
グループ サービス
|
Group Service | True | string |
使用するグループ サービス。 |
|
電話番号
|
Phone | True | string |
削除する連絡先の電話番号。 |
戻り値
- 返答
- boolean
グループ連絡先を取得する
グループ連絡先を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer | True | string |
グループ サービスを取り込む顧客。 |
|
グループ サービス
|
Group Service | True | string |
使用するグループ サービス。 |
|
電話番号
|
Phone | True | string |
連絡先の電話番号。 |
|
Region
|
Region | string |
電話番号の解析に使用するオプションの Phonenumber リージョン。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
電話番号
|
phone | string |
連絡先の電話番号。 |
|
メール
|
string |
連絡先の電子メール アドレス。 |
|
|
名
|
firstName | string |
連絡先の名前。 |
|
姓
|
lastName | string |
連絡先の苗字。 |
|
Gender
|
gender | string |
連絡先の性別。 |
|
誕生年
|
birthYear | integer |
連絡先の生年月日。 |
|
住所
|
streetAddress | string |
連絡先の住所の番地。 |
|
Zip Code
|
zipCode | string |
連絡先の郵便番号。 |
|
都市
|
city | string |
連絡先の所在市。 |
|
Country Code
|
countryCode | string |
連絡先の国コード。 |
|
失敗したメッセージ
|
failedMessages | integer |
失敗した連絡先のメッセージの数。 |
|
カスタム プロパティ
|
customContactProperties | array of object |
連絡先用に保存されたカスタム連絡先プロパティ コレクション。 |
|
件名
|
customContactProperties.name | string |
カスタム連絡先プロパティ名。 |
|
価値
|
customContactProperties.value | string |
カスタム連絡先プロパティの値。 |
ディスカッション返信メッセージを送信する
ディスカッション返信メッセージを受信者に送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
顧客
|
CustomerId | True | string |
送信に使用する顧客。 |
|
スレッド ID
|
ThreadId | True | string |
返信先の既存スレッドの ID。 |
|
メッセージ コンテンツ
|
Content | True | string |
メッセージのコンテンツ。 |
|
顧客データ
|
CustomerData | string |
このメッセージの請求/グループ化データです (オプション)。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ ID
|
MessageId | string |
新たに作成されたメッセージの識別子。 |
|
メッセージ部分数
|
MessagePartCount | integer |
このメッセージのメッセージ パーツのおおよその数。 |
|
受信者
|
Recipients | array of object |
受信者 |
|
受信者のアドレス
|
Recipients.Address | string |
受信者のアドレス (電話番号/電子メール/ユーザー ID など)。 |
|
受信者 ID
|
Recipients.Id | string |
配信状態に関する情報の受信に使用される受信者識別子。 |
|
ThreadId
|
ThreadId | string |
メッセージを送信した先のスレッドを表す識別子。 |
メッセージを送信する
受信者にメッセージを送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
顧客
|
Customer-Id | True | string |
送信に使用する顧客。 |
|
Service
|
Service-Id | True | string |
送信に使用するサービス。 |
|
メッセージ送信者
|
Sender | True | string |
メッセージの送信者は、英数字、ロング コード、またはショート コードにすることができます (制限が適用されます)。 |
|
メッセージ コンテンツ
|
Content | True | string |
メッセージのコンテンツ。 |
|
メッセージ プロトコル
|
Protocol | True | string |
メッセージの送信に使用するプロトコル。 |
|
送信日時
|
SendDateTime | date-time |
メッセージを送信する日時。 すぐに送信するには、空のままにします。 |
|
|
住所
|
Address | True | string |
メッセージ受信者のアドレス。 |
|
添付 URI
|
AttachmentUri | string |
添付ファイルを含む WhatsApp メッセージの送信時に使用する添付ファイルの URI。 |
|
|
顧客データ
|
CustomerData | string |
このメッセージの請求/グループ化データです (オプション)。 |
|
|
広告メッセージ
|
AdMessage | boolean |
メッセージを広告メッセージとしてマークするためのオプションの上書きフラグ |
|
|
配信レポート URL
|
DlrUrl | string |
http-get を介した配信状態コールバックの URL。 クエリ文字列の値を URL に追加しても、それらは保持されます。 |
|
|
要求 ID
|
RequestId | string |
重複した要求を特定するために使用できるオプションの一意の要求 ID。 重複するリクエスト ID が検出された場合、送信はキャンセルされます。 スループット/トラフィックが高い状況で、重複するリクエスト ID を持つリクエストがブロックされるという保証はありません。 指定された requestId は 7 日間 "記憶" されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ Id
|
MessageId | string |
新たに作成されたメッセージの識別子。 |
|
メッセージ部分数
|
MessagePartCount | integer |
このメッセージのメッセージ パーツのおおよその数。 |
|
受信者
|
Recipients | array of object |
受信者 |
|
受信者のアドレス
|
Recipients.Address | string |
受信者のアドレス (電話番号/電子メール/ユーザー ID など)。 |
|
受信者 ID
|
Recipients.Id | string |
配信状態に関する情報の受信に使用される受信者識別子。 |
返信メッセージを送信する
受信者に返信メッセージを送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ParentMessage ID
|
ParentMessageId | True | string |
返信先の親メッセージ ID。 |
|
顧客
|
Customer-Id | True | string |
送信に使用する顧客。 |
|
サービス
|
Service-Id | True | string |
送信に使用するサービス。 |
|
メッセージ送信者
|
Sender | True | string |
メッセージの送信者は、英数字、ロング コード、またはショート コードにすることができます (制限が適用されます)。 |
|
メッセージ コンテンツ
|
Content | True | string |
メッセージのコンテンツ。 |
|
メッセージ プロトコル
|
Protocol | True | string |
メッセージの送信に使用するプロトコル。 |
|
送信日時
|
SendDateTime | date-time |
メッセージを送信する日時。 すぐに送信するには、空のままにします。 |
|
|
住所
|
Address | True | string |
メッセージ受信者のアドレス。 |
|
添付 URI
|
AttachmentUri | string |
添付ファイルを含む WhatsApp メッセージの送信時に使用する添付ファイルの URI。 |
|
|
顧客データ
|
CustomerData | string |
このメッセージの請求/グループ化データです (オプション)。 |
|
|
広告メッセージ
|
AdMessage | boolean |
メッセージを広告メッセージとしてマークするためのオプションの上書きフラグ |
|
|
配信レポート URL
|
DlrUrl | string |
http-get を介した配信状態コールバックの URL。 クエリ文字列の値を URL に追加しても、それらは保持されます。 |
|
|
要求 ID
|
RequestId | string |
重複した要求を特定するために使用できるオプションの一意の要求 ID。 重複するリクエスト ID が検出された場合、送信はキャンセルされます。 スループット/トラフィックが高い状況で、重複するリクエスト ID を持つリクエストがブロックされるという保証はありません。 指定された requestId は 7 日間 "記憶" されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ Id
|
MessageId | string |
新たに作成されたメッセージの識別子。 |
|
メッセージ部分数
|
MessagePartCount | integer |
このメッセージのメッセージ パーツのおおよその数。 |
|
受信者
|
Recipients | array of object |
受信者 |
|
受信者のアドレス
|
Recipients.Address | string |
受信者のアドレス (電話番号/電子メール/ユーザー ID など)。 |
|
受信者 ID
|
Recipients.Id | string |
配信状態に関する情報の受信に使用される受信者識別子。 |
トリガー
| 新しいメッセージ |
新しいメッセージが双方向サービスに届いたとき。 |
新しいメッセージ
新しいメッセージが双方向サービスに届いたとき。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
大変お世話になっております
|
Customer | True | string |
使用する顧客。 |
|
Service
|
Service | True | string |
使用する双方向サービス。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ送信者
|
sender | string |
メッセージ送信者。 |
|
メッセージ受信者
|
recipient | string |
メッセージ受信者。 |
|
メッセージ コンテンツ
|
content | string |
受信メッセージのコンテンツ。 |
|
メッセージ タイムスタンプ
|
timestamp | date-time |
メッセージのタイムスタンプ。 |
|
メッセージ プロトコル
|
protocol | string |
受信メッセージのプロトコル。 |
|
添付ファイル
|
attachments | array of object |
添付ファイル |
|
添付ファイル名
|
attachments.name | string |
添付ファイル名。 |
|
添付ファイルの MIME の種類
|
attachments.mimeType | string |
添付ファイルの MIME の種類。 |
|
添付ファイル リソースの場所
|
attachments.resourceLocation | string |
添付ファイル リソースの場所。 |
|
メッセージ Id
|
messageId | string |
受信したメッセージの一意メッセージ ID。 |
定義
uuid
ブール値
これは基本的なデータ型 'ブール値' です。