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 が含まれますが、これらに限定されません。

前提条件

  1. SmartDialog サブスクリプションとアカウント。 sales@arenainteractive.fi にお問い合わせください
  2. メッセージを受信するには、入力ソースも必要です。 これらは、国内ショートコード、国際ロングコード、または 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 秒

アクション

WhatsApp オプトアウト (非推奨) [非推奨]

送信者と受信者に対する WhatsApp オプトアウト。 (非推奨)

WhatsApp オプトイン (非推奨) [非推奨]

送信者と受信者に対する WhatsApp オプトイン。 (非推奨)

WhatsApp テンプレートを作成する

新しい WhatsApp テンプレートを作成する

WhatsApp メッセージを送信する

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

連絡先の電話番号。

メール
email 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

連絡先がアクティブかどうかを示すフラグ。

メール
email 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

連絡先の電話番号。

メール
email 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

作成された連絡先の一意の ID。

作成された連絡先の一意の ID。

連絡先 ID
uuid

ブール値

これは基本的なデータ型 'ブール値' です。