次の方法で共有


Text Request

Text Request は、企業が会話を顧客に変えるのに役立つビジネス テキスト メッセージ プラットフォームです。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Text Request API サポート
[URL] https://www.textrequest.com/contact
メール apidev@textrequest.com
Connector Metadata
発行者 Text Request
Web サイト https://www.textrequest.com/
プライバシー ポリシー https://www.textrequest.com/privacy-policy/
カテゴリー 通信; 営業と CRM

Text Request は、顧客とつながり、エンゲージメントを促進し、顧客を売上に変えるのに役立つビジネス テキスト メッセージ ソリューションです。 Text Request を使用すると、ビジネス テキスト メッセージを別々の電話回線に編成し、顧客へのマーケティングを迅速かつ効率的に開始できます。

前提条件

このコネクタには、API アクセス を持った Text Request アカウントが必要です。 詳細については、私たちの Web サイト をご覧ください。

資格情報の入手方法

この統合を使用するには、テキスト リクエストから API キーを取得する必要があります。 Text Request プランに API アクセスがあるかどうかを確認するには、プランの内訳 をご覧ください。 API アクセスがないプランをお持ちの場合は、50$/月のアドオン機能として追加できます。

  • Text Request アカウントにサインインします
  • 左側のナビゲーション サイドバーの統合ページをクリックします
  • API タイルを検索します。 リンクに "今すぐ追加" と表示されている場合は、API アクセスのプランがありません。 "今すぐ追加" リンクをクリックして追加できます。 それ以外の場合は、"API キーと Webhook" のリンクをクリックします
  • API キーを選択して、コピーします。 このキーは、接続を承認するために必要なすべてです

コネクタの使用を開始する

Power Automate でこの接続を選択して接続するには、API キーを入力するよう求められます。 その後、接続を使用して、他の接続でトリガーが設定されるたびに、テキスト メッセージを送信し、テキスト リクエストで連絡先情報を更新できます。 顧客が Hubspot にサインオンしたときにトリガーする自動化を作成して、最初のテキストを送信したり、特別なグループに配置したりできます。 Survey Monkey に接続して、連絡先がフォームを送信したときに Text Request に追加できます。

既知の問題と制限事項

このコネクタに含まれていない Text Request API の呼び出しがいくつかあります。 具体的には、Text Request の Webhook をフロー トリガーとして使用することは含まれていません。 Text Request アカウントにアクセスし、API キーを取得したのと同じ場所に移動して、アカウントに Webhook を追加できます。ただし、自動化を有効にすることはできません。 含まれていない API 呼び出しについては、API ドキュメントに こちら からアクセスでき、Power Automate の HTTP アクションを使って未使用の呼び出しへの呼び出しを作成します。

一般的なエラーと解決策

いずれかのリクエストで 404 エラーが発生した場合は、渡されたダッシュボード ID を再確認してください。 GetDashboards アクションを使用して、ダッシュボードとその ID のリストを表示できます。

連絡先またはその他の値を取得している場合、自動的に入力される yes/no の値に気付く場合があります。 これらの値は 必須ではありません が、無効な回答が含まれないように、デフォルトで含まれています。 連絡先が非表示、アーカイブ、ブロック、またはオプトアウトされているかどうかに関係なく、すべての連絡先を取得するには、そのフィールドからデフォルトの "いいえ" の値を削除します。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
API キー securestring この API の API キー True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

ID を指定してグループを取得します

指定された ID を持つグループを取得します。

このダッシュボードのすべての会話を取得する

このダッシュボードのすべての会話を取得し、各会話の最後のメッセージに関する情報を含めます。

この特定のダッシュボードに関する情報を取得する

ダッシュボードの名前と電話番号を返します。

すべてのカスタム フィールドの取得

このダッシュボードのすべてのカスタム フィールドを取得します。 カスタム フィールドは、ダッシュボード間で一意です。

すべてのグループを取得します

ユーザーのアカウントのすべてのグループを取得します。

すべてのタグを取得する

このダッシュボードのすべてのタグを取得します。 タグは、ダッシュボード間で一意です。

すべての支払いを取得

キャンセルされた支払いと支払い済みの支払いを含む、すべての支払いを取得します。 これらは、クエリ パラメーターを使用してフィルター処理できます。

アカウント内のすべてのダッシュボードを取得する

アカウント内のすべてのダッシュボードを返します。

会話をアーカイブする

会話をアーカイブすると、すべての会話取得エンドポイントの結果から会話が削除されます。 顧客がテキスト リクエスト番号にテキストを送信した場合、または Text Request 番号から顧客にテキストを送信した場合、会話は自動的にアーカイブ解除されます。 会話をアーカイブすることは、今後話す予定のない顧客から混乱を取り除く良い方法です。 顧客がこれ以上 SMS メッセージを送信できないように "STOP" とテキスト メッセージを送信した場合、会話は自動的にアーカイブされることに注意してください。

会話をアーカイブ解除する

会話をアーカイブ解除します。 会話がアーカイブ解除されると、再びキューに表示されます。 /conversations エンドポイント によって返される会話にも表示されます。 会話が既にアーカイブ解除されている場合、このメソッドは効果がありません。

指定された ID でグループを更新します

グループの数値IDを使用してグループの名前を更新します。渡されたグループ ID が存在しない場合、呼び出しは失敗します。

指定された ID を持つグループを削除します

指定された ID を持つグループを削除します。これは、グループのメンバーである連絡先がある場合でも成功します (連絡先は削除されません)。

指定された ID を持つ支払いを取得する

指定された ID を持つ支払いを取得します。

指定されたフィルタリング条件に一致するすべての連絡先を取得する

指定されたフィルタリング条件に一致するすべての連絡先を取得します。 指定されたダッシュボードのみが検索されます。使用可能な番号のアカウント レベルの検索はありません。

指定された名前と電話番号で新しいダッシュボードを作成します

アカウントに新しいダッシュボードを作成します。 ダッシュボードが作成されると、管理者に変更に関するメールが送信され、ユーザーの割り当てを開始できます。 このエンドポイントは、プロビジョニングされた番号のダッシュボードを作成できます。 GET /dashboards/provisioning を使用して、特定の市外局番でプロビジョニングされた番号を検索できます。 電話番号が既に使用されている場合は、Bad Request 例外がスローされます。

指定された支払いをキャンセルする

指定された支払いをキャンセルし、支払いがキャンセルされたことをユーザーに通知します。 支払いは編集できないため、キャンセルして新しい支払いを発行することが、支払いを修正する最善の方法です。

指定された支払いを支払うようユーザーに通知するフォローアップ テキストを送信する

指定された支払いを支払うよう連絡先にリマインダーを送信します。 メッセージの内容は自動生成されます。 スパムを避けるため、支払いごとに送信できるリマインダーは 1 つだけです

指定された電話番号の連絡先にメッセージを送信します

メッセージを送信します (指定された電話番号にメッセージ履歴がない場合は、新しい会話を開始します)。

指定したダッシュボードを削除します

指定したダッシュボードを削除します。

指定した電話番号の連絡先を削除します

このダッシュボードにこの電話番号の連絡先が存在しない場合、コンテンツは返されません。 連絡先が存在するが、メッセージ履歴がない場合、コンテンツは返されず、正常な状態コードは削除されたことを示します。 連絡先にメッセージ履歴がある場合は削除できず、Bad Request エラーが返されます。

指定した電話番号の連絡先を取得します

このダッシュボードにこの電話番号の連絡先が存在しない場合、コンテンツは返されず、エラーはスローされません。 指定されたダッシュボードのみ検索され、連絡先はダッシュボードごとに整理され、アカウント レベルで番号を検索することはできません。

支払いを支払い済としてマークする

支払いを "支払い済" としてクローズします。 この エンドポイント は、支払いリクエスト ポータル以外の手段で支払いが行われる場合に使用します。 これにより支払いが終了し、その支払い額が統計に追加されます。 このエンドポイントは、テキスト リクエストを通じて送信された支払いポータルを通じて支払われる支払いには必要ありません。これにより、支払いが自動的に支払い済みとしてマークされます。

新しい支払いの作成

指定された連絡先への指定されたメッセージで新しい支払いを作成します。

新規グループの作成

提供された名前を持つ新規グループを作成する。

特定のダッシュボード名を更新する

ダッシュボードを更新します。 これにより、ダッシュボードの電話番号が変更されることはありません。 別のダッシュボードの連絡先で新しい番号が必要な場合は、POST で新しいダッシュボードを作成し、一括エクスポート/インポートで連絡先を追加する必要があります。

連絡先の一括更新

指定されたダッシュボードのみに連絡先が追加されます。連絡先はダッシュボードごとに整理されており、アカウント レベルで番号を検索することはできません。

連絡先の電話番号で会話のメッセージを取得する

指定されたダッシュボードと電話番号の間の会話を取得します。

連絡先を作成または更新する

連絡先を作成または更新します (指定された電話番号の連絡先が既に存在するかどうかによって異なります)。

ID を指定してグループを取得します

指定された ID を持つグループを取得します。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

グループの ID
group_id True integer

取得するグループの数値 ID。

戻り値

名前 パス 説明
id
id integer

グループの数値 ID。

group_member_count
group_member_count integer

グループ内のメンバーの数。

is_keyword
is_keyword boolean

このグループがキーワード グループかどうか。 このようなグループは、ユーザーがキーワードを設定すると自動生成されます。 連絡先は、登録時に自動的に追加されます。

名称
name string

このグループの名前。

メモ
notes string

このグループに関するメモ。

last_message_sent_utc
last_message_sent_utc string

最後のグループ メッセージがこのグループに送信されたときのタイムスタンプ。

このダッシュボードのすべての会話を取得する

このダッシュボードのすべての会話を取得し、各会話の最後のメッセージに関する情報を含めます。

パラメーター

名前 キー 必須 説明
連絡先タグ
tags string

会話をフィルター処理するタグを参照する GUID のカンマ区切りリスト。

解決済みの会話のみを表示するかどうか
show_unresolved_only string

会話が解決された連絡先のみを検索するかどうか。 これがfalseの場合、解決済みの会話と未解決の会話の両方が表示されます。

アーカイブした会話を含めるかどうか
include_archived string

アーカイブされた連絡先との会話を含めるかどうか。

電話番号と連絡先名をフィルターする用語
search string

電話番号または表示名で会話をフィルタリングするための 検索語句。 検索語句 が氏名または電話番号よりも小さい場合、検索はそれに部分的に一致するすべての会話を返します。

取得するページ番号
page integer

取得するエンティティのページ。 値を取得する場合、page_size で定義されたページあたりの最大サイズがあります。 ページが最後のページより大きい場合、空の配列が返されます。

ページごとに取得する各エンティティの量
page_size integer

取得する各ページのサイズ。 値を取得する場合、これはページごとの最大サイズであり、後続のページへのアクセスはページ パラメータによって行われます。

この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

名前 パス 説明
page
meta.page integer

取得するエンティティのページ。 このページ内のエンティティの量は、page_size によって定義されます。

page_size
meta.page_size integer

このページで取得したエンティティの数。

total_items
meta.total_items integer

ページのサイズや数に関係なく、データベースで使用できるエンティティの数。 他のページを表示するには、リクエストでページ番号を変更します。

アイテム
items array of object

Text Request から取得した会話エンティティのリスト。

phone_number
items.phone_number string

取引先担当者の電話番号。

message_id
items.last_message.message_id string

メッセージの ID。 この値は各メッセージに対して固有のものです。

body
items.last_message.body string

このメッセージのコンテンツ。

message_direction
items.last_message.message_direction string

R または S のいずれかの単数文字で、このメッセージが連絡先から受信されたか、連絡先に送信されたかをそれぞれ示します。

response_by_username
items.last_message.response_by_username string

このユーザーに最後にメッセージを送信した Text Request ユーザーのユーザー名。

message_timestamp_utc
items.last_message.message_timestamp_utc string

Text Request によってメッセージが送信、または受信されたときのタイムスタンプ。

delivery_status
items.last_message.delivery_status string

このメッセージの現在の状態。 これは、'送信中'、'配信済み'、'エラー'、または '送信' のいずれかです。

delivery_error
items.last_message.delivery_error string

このメッセージが配信されない原因となったエラー。 delivery_status が 'エラー' でない場合、この値は null になります。

mms_media
items.last_message.mms_media array of string

このメッセージの添付ファイルを指す URL のリスト。 すべての URL は、テキスト リクエストによって生成された URL になります。

この特定のダッシュボードに関する情報を取得する

ダッシュボードの名前と電話番号を返します。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

名前 パス 説明
id
id integer

ダッシュボードの数値 ID。

名称
name string

ダッシュボードの名前。

電話番号
phone string

このダッシュボードに関連付けられたテキスト番号。

すべてのカスタム フィールドの取得

このダッシュボードのすべてのカスタム フィールドを取得します。 カスタム フィールドは、ダッシュボード間で一意です。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

名前 パス 説明
array of object
id
id string

フィールドの数値 ID。

名称
name string

カスタム フィールドの名前。

すべてのグループを取得します

ユーザーのアカウントのすべてのグループを取得します。

パラメーター

名前 キー 必須 説明
取得するページ番号
page True integer

取得するエンティティのページ。 値を取得する場合、page_size で定義されたページあたりの最大サイズがあります。 ページが最後のページより大きい場合、空の配列が返されます。

ページごとに取得する各エンティティの量
page_size True integer

取得する各ページのサイズ。 値を取得する場合、これはページごとの最大サイズであり、後続のページへのアクセスはページ パラメータによって行われます。

この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

名前 パス 説明
page
meta.page integer

取得するエンティティのページ。 このページ内のエンティティの量は、page_size によって定義されます。

page_size
meta.page_size integer

このページで取得したエンティティの数。

total_items
meta.total_items integer

ページのサイズや数に関係なく、データベースで使用できるエンティティの数。 他のページを表示するには、リクエストでページ番号を変更します。

アイテム
items array of object

Text Request から取得したグループ エンティティのリスト。

id
items.id integer

グループの数値 ID。

group_member_count
items.group_member_count integer

グループ内のメンバーの数。

is_keyword
items.is_keyword boolean

このグループがキーワード グループかどうか。 このようなグループは、ユーザーがキーワードを設定すると自動生成されます。 連絡先は、登録時に自動的に追加されます。

名称
items.name string

このグループの名前。

メモ
items.notes string

このグループに関するメモ。

last_message_sent_utc
items.last_message_sent_utc string

最後のグループ メッセージがこのグループに送信されたときのタイムスタンプ。

すべてのタグを取得する

このダッシュボードのすべてのタグを取得します。 タグは、ダッシュボード間で一意です。

パラメーター

名前 キー 必須 説明
取得するページ番号
page True integer

取得するエンティティのページ。 値を取得する場合、page_size で定義されたページあたりの最大サイズがあります。 ページが最後のページより大きい場合、空の配列が返されます。

ページごとに取得する各エンティティの量
page_size True integer

取得する各ページのサイズ。 値を取得する場合、これはページごとの最大サイズであり、後続のページへのアクセスはページ パラメータによって行われます。

この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

名前 パス 説明
page
meta.page integer

取得するエンティティのページ。 このページ内のエンティティの量は、page_size によって定義されます。

page_size
meta.page_size integer

このページで取得したエンティティの数。

total_items
meta.total_items integer

ページのサイズや数に関係なく、データベースで使用できるエンティティの数。 他のページを表示するには、リクエストでページ番号を変更します。

アイテム
items array of object

Text Request から取得したタグ エンティティのリスト。

id
items.id string

タグの数値 ID。

tag_color
items.tag_color string

タグの色。 これは、有効な 16 進数のカラー コードである必要があります。

tag
items.tag string

タグの名前。

すべての支払いを取得

キャンセルされた支払いと支払い済みの支払いを含む、すべての支払いを取得します。 これらは、クエリ パラメーターを使用してフィルター処理できます。

パラメーター

名前 キー 必須 説明
支払いの参照文字列
reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

支払いの電話番号
phone_number string

送信されるこの支払いの連絡先の電話番号。

並べ替え順
sort_type string

支払いを並べ替えるプロパティ条件。 "金額"、"連絡先"、"日付"、"ステータス" のいずれかです。

ソート方向
sort_direction string

支払いを並べ替える方向。 "desc" は降順、または "asc" は昇順で指定できます。

取得するページ番号
page True integer

取得するエンティティのページ。 値を取得する場合、page_size で定義されたページあたりの最大サイズがあります。 ページが最後のページより大きい場合、空の配列が返されます。

ページごとに取得する各エンティティの量
page_size True integer

取得する各ページのサイズ。 値を取得する場合、これはページごとの最大サイズであり、後続のページへのアクセスはページ パラメータによって行われます。

この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

名前 パス 説明
page
meta.page integer

取得するエンティティのページ。 このページ内のエンティティの量は、page_size によって定義されます。

page_size
meta.page_size integer

このページで取得したエンティティの数。

total_items
meta.total_items integer

ページのサイズや数に関係なく、データベースで使用できるエンティティの数。 他のページを表示するには、リクエストでページ番号を変更します。

アイテム
items array of object

Text Request から取得した連絡先エンティティのリスト。

payment_id
items.payment_id integer

支払いの数値 ID。

request_date
items.request_date string

この支払いの最初のメッセージが送信キューに入れられたときのタイムスタンプ。

受信者
items.recipient string

支払い受信者の名前。 連絡先の電話番号に名前が関連付けられていない場合、これは null になる可能性があります。

description
items.description string

支払いの説明。 これは連絡先に表示されません。 これは、支払いに関するコンテキストのために内部ユーザーによってのみ使用されます。

customer_phone
items.customer_phone string

この支払いの送信先の連絡先の電話番号。

amount_requested
items.amount_requested float

この支払いで要求されたドル単位の金額。

is_past_due
items.is_past_due boolean

この支払いが要求日を過ぎているかどうか。

reminder_was_sent
items.reminder_was_sent boolean

この支払いに対してテキスト リマインダーが既に送信されているかどうか。

transaction_status
items.transaction_status string

authvia のトランザクションの状態。 この値は不明として開始します。

textrequest_payment_status
items.textrequest_payment_status string

Text Request のトランザクションの状態。 これは、Text Request アプリの支払いページに表示されるステータスを表します。 これは送信済みとして開始されます。

reference_number
items.reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

アカウント内のすべてのダッシュボードを取得する

アカウント内のすべてのダッシュボードを返します。

パラメーター

名前 キー 必須 説明
取得するページ番号
page True integer

取得するエンティティのページ。 値を取得する場合、page_size で定義されたページあたりの最大サイズがあります。 ページが最後のページより大きい場合、空の配列が返されます。

ページごとに取得する各エンティティの量
page_size True integer

取得する各ページのサイズ。 値を取得する場合、これはページごとの最大サイズであり、後続のページへのアクセスはページ パラメータによって行われます。

戻り値

名前 パス 説明
page
meta.page integer

取得するエンティティのページ。 このページ内のエンティティの量は、page_size によって定義されます。

page_size
meta.page_size integer

このページで取得したエンティティの数。

total_items
meta.total_items integer

ページのサイズや数に関係なく、データベースで使用できるエンティティの数。 他のページを表示するには、リクエストでページ番号を変更します。

アイテム
items array of object

Text Request から取得したダッシュボード エンティティのリスト。

id
items.id integer

ダッシュボードの数値 ID。

名称
items.name string

ダッシュボードの名前。

電話番号
items.phone string

このダッシュボードに関連付けられたテキスト番号。

会話をアーカイブする

会話をアーカイブすると、すべての会話取得エンドポイントの結果から会話が削除されます。 顧客がテキスト リクエスト番号にテキストを送信した場合、または Text Request 番号から顧客にテキストを送信した場合、会話は自動的にアーカイブ解除されます。 会話をアーカイブすることは、今後話す予定のない顧客から混乱を取り除く良い方法です。 顧客がこれ以上 SMS メッセージを送信できないように "STOP" とテキスト メッセージを送信した場合、会話は自動的にアーカイブされることに注意してください。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

会話の電話番号
phone_number True string

アーカイブする会話の電話番号。

戻り値

返答
string

会話をアーカイブ解除する

会話をアーカイブ解除します。 会話がアーカイブ解除されると、再びキューに表示されます。 /conversations エンドポイント によって返される会話にも表示されます。 会話が既にアーカイブ解除されている場合、このメソッドは効果がありません。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

会話の電話番号
phone_number True string

アーカイブする会話の電話番号。

戻り値

返答
string

指定された ID でグループを更新します

グループの数値IDを使用してグループの名前を更新します。渡されたグループ ID が存在しない場合、呼び出しは失敗します。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

グループの ID
group_id True integer

更新するグループの数値 ID。

Group name
name string

グループの新しい名前。

グループ ノート
notes string

グループを説明する短いフレーズ。 便宜上の使用。

戻り値

名前 パス 説明
id
id integer

グループの数値 ID。

group_member_count
group_member_count integer

グループ内のメンバーの数。

is_keyword
is_keyword boolean

このグループがキーワード グループかどうか。 このようなグループは、ユーザーがキーワードを設定すると自動生成されます。 連絡先は、登録時に自動的に追加されます。

名称
name string

このグループの名前。

メモ
notes string

このグループに関するメモ。

last_message_sent_utc
last_message_sent_utc string

最後のグループ メッセージがこのグループに送信されたときのタイムスタンプ。

指定された ID を持つグループを削除します

指定された ID を持つグループを削除します。これは、グループのメンバーである連絡先がある場合でも成功します (連絡先は削除されません)。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

グループの ID
group_id True integer

削除するグループの数値 ID。

戻り値

返答
string

指定された ID を持つ支払いを取得する

指定された ID を持つ支払いを取得します。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

支払いの ID
payment_id True integer

取得する支払いの数値 ID。

戻り値

名前 パス 説明
payment_id
payment_id integer

支払いの数値 ID。

request_date
request_date string

この支払いの最初のメッセージが送信キューに入れられたときのタイムスタンプ。

受信者
recipient string

支払い受信者の名前。 連絡先の電話番号に名前が関連付けられていない場合、これは null になる可能性があります。

description
description string

支払いの説明。 これは連絡先に表示されません。 これは、支払いに関するコンテキストのために内部ユーザーによってのみ使用されます。

customer_phone
customer_phone string

この支払いの送信先の連絡先の電話番号。

amount_requested
amount_requested float

この支払いで要求されたドル単位の金額。

is_past_due
is_past_due boolean

この支払いが要求日を過ぎているかどうか。

reminder_was_sent
reminder_was_sent boolean

この支払いに対してテキスト リマインダーが既に送信されているかどうか。

transaction_status
transaction_status string

authvia のトランザクションの状態。 この値は不明として開始します。

textrequest_payment_status
textrequest_payment_status string

Text Request のトランザクションの状態。 これは、Text Request アプリの支払いページに表示されるステータスを表します。 これは送信済みとして開始されます。

reference_number
reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

指定されたフィルタリング条件に一致するすべての連絡先を取得する

指定されたフィルタリング条件に一致するすべての連絡先を取得します。 指定されたダッシュボードのみが検索されます。使用可能な番号のアカウント レベルの検索はありません。

パラメーター

名前 キー 必須 説明
検索する連絡先の電話番号
contact_phone_number string

連絡先をフィルタリングする電話番号。

'Last-message-time sent before' 検索タイムスタンプ (UTC 時間)
last_message_timestamp_before_utc date-time

最後に送受信されたメッセージで連絡先を検索するためのカットオフ時間。 この時間以降にメッセージを送信した連絡先は表示されません。

'Last-message-time sent after' 検索タイムスタンプ (UTC 時間)
last_message_timestamp_after_utc date-time

最後に送受信されたメッセージで連絡先を検索するためのカットオフ時間。 この時間以前にメッセージを送信した連絡先は表示されません。

'これ以前に作成' の検索タイムスタンプ
contact_created_before date-time

連絡先を作成日で検索するための締め切り時間。 この時間以降にメッセージを作成した連絡先は表示されません。

'これ以後に作成' の検索タイムスタンプ
contact_created_after date-time

連絡先を作成日で検索するための締め切り時間。 この時間以前にメッセージを作成した連絡先は表示されません。

連絡先との現在の会話が解決されたかどうか
is_resolved boolean

会話が解決された連絡先を検索するかどうか。

連絡先がブロックされているかどうか
is_blocked boolean

ブロックされた連絡先を検索するかどうか。

連絡先がアーカイブされているかどうか
is_archived boolean

アーカイブされた連絡先を検索するかどうか。

連絡先が非表示にされているかどうか
is_suppressed boolean

非表示にされた連絡先を検索するかどうか。

連絡先がオプトアウトしたかどうか
has_opted_out boolean

テキストの受信をオプトアウトした連絡先を検索するかどうか。

'Last-message-time sent before' 検索タイムスタンプ
last_message_sent_before date-time

最後にメッセージが顧客に送信されたされた時別で連絡先を検索するためのカットオフ時間。 この時間以降にメッセージを送信した連絡先は表示されません。 ローカル タイムでのタイムスタンプを使います。 UTC 時間のタイムスタンプでフィルタリングするには、last_message_sent_before_utc を使用します

'Last-message-time sent after' 検索タイムスタンプ
last_message_sent_after date-time

最後にメッセージが顧客に送信されたされた時別で連絡先を検索するためのカットオフ時間。 この時間以前にメッセージを送信した連絡先は表示されません。 ローカル タイムでのタイムスタンプを使います。 UTC 時間のタイムスタンプでフィルタリングするには、last_message_sent_after_utc を使用します

'Last-message-time received before' 検索タイムスタンプ
last_message_received_before date-time

最後にメッセージが顧客から受信されたされた時別で連絡先を検索するためのカットオフ時間。 この時間以降にメッセージを受信した連絡先は表示されません。 ローカル タイムでのタイムスタンプを使います。 UTC 時間のタイムスタンプでフィルタリングするには、last_message_sent_before_utc を使用します

'Last-message-time received after' 検索タイムスタンプ
last_message_received_after date-time

最後にメッセージが顧客から受信されたされた時別で連絡先を検索するためのカットオフ時間。 この時間以前にメッセージを送信した連絡先は表示されません。 ローカル タイムでのタイムスタンプを使います。 UTC 時間のタイムスタンプでフィルタリングするには、last_message_sent_before_utc を使用します

連絡先タグ
tags string

連絡先をフィルター処理するタグを参照する GUID のカンマ区切りリスト。

連絡先グループ
groups string

連絡先をフィルター処理するグループを参照する 整数 ID のカンマ区切りリスト。

フィルターするカスタム フィールドの ID
custom_field_id_1 string

連絡先をフィルター処理するためのカスタム フィールドを参照するガイド。

フィルターするカスタム フィールドの値
custom_field_value_1 string

連絡先をフィルター処理するためのカスタム フィールドを参照する値。

フィルターする二次カスタム フィールドの ID
custom_field_id_2 string

連絡先をフィルター処理するための 2 番目のカスタム フィールドを参照するガイド。

フィルターする 2 番目のカスタム フィールドの値
custom_field_value_2 string

連絡先をフィルター処理するための二次カスタム フィールドを参照する値。

フィルターする 3 番目のカスタム フィールドの ID
custom_field_id_3 string

連絡先をフィルター処理するための 3 番目のカスタム フィールドを参照するガイド。

フィルターする 3 番目のカスタム フィールドの値
custom_field_value_3 string

連絡先をフィルター処理するための 3 番目のカスタム フィールドを参照する値。

取得するページ番号
page True integer

取得するエンティティのページ。 値を取得する場合、page_size で定義されたページあたりの最大サイズがあります。 ページが最後のページより大きい場合、空の配列が返されます。

ページごとに取得する各エンティティの量
page_size True integer

取得する各ページのサイズ。 値を取得する場合、これはページごとの最大サイズであり、後続のページへのアクセスはページ パラメータによって行われます。

この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

名前 パス 説明
page
meta.page integer

取得するエンティティのページ。 このページ内のエンティティの量は、page_size によって定義されます。

page_size
meta.page_size integer

このページで取得したエンティティの数。

total_items
meta.total_items integer

ページのサイズや数に関係なく、データベースで使用できるエンティティの数。 他のページを表示するには、リクエストでページ番号を変更します。

アイテム
items array of object

テキスト リクエストから取得した連絡先エンティティのリスト。

phone_number
items.phone_number string

この連絡先の電話番号。

first_name
items.first_name string

この連絡先の名。

items.last_name string

この連絡先の姓。

display_name
items.display_name string

この連絡先の氏名。 これは、連絡先を表示するときに Web アプリに表示されるデフォルトの名前です。

is_suppressed
items.is_suppressed boolean

この連絡先との会話を抑制して、受信時にメッセージ キューの先頭にプッシュしないかどうか。

is_archived
items.is_archived boolean

この連絡先との会話をアーカイブするかどうか、したがって、会話のクエリを実行しても表示されません (デフォルトで)。

is_blocked
items.is_blocked boolean

この連絡先との会話をブロックするかどうか、したがって、受信も保存もされません。

suppressed_reason
items.suppressed_reason string

連絡を差し控える理由を説明するフレーズ。 is_suppressed が false の場合、これは null になります。

note
items.note string

連絡先を説明する短いフレーズ。 便宜上の使用。 これは連絡先に表示されることはありません。

groups
items.groups array of integer

この連絡先が属するグループを参照する整数 ID の配列。

contact_tags
items.contact_tags array of string

この連絡先に添付されたタグを参照する GUID の配列。

custom_fields
items.custom_fields array of object

この連絡先に定義されたカスタム フィールド ID と値の配列。

id
items.custom_fields.id string

カスタム フィールドを参照するガイド。

価値
items.custom_fields.value string

このカスタム フィールドのこの連絡先の値。

is_resolved
items.is_resolved boolean

この連絡先との現在の会話が解決されたかどうか。 この連絡先が新しいテキストを受信すると、これは false に設定されます。

first_contact_utc
items.first_contact_utc string

この連絡先に最初のメッセージが送信されたときのタイムスタンプ。

opted_out_utc
items.opted_out_utc string

この連絡先がメッセージの受信をオプトアウトしたときのタイムスタンプ。

last_msg_sent_utc
items.last_msg_sent_utc string

この連絡先に最後のメッセージが送信されたときのタイムスタンプ。

last_msg_received_utc
items.last_msg_received_utc string

この連絡先から最後のメッセージが受信されたときのタイムスタンプ。

total_msgs_sent
items.total_msgs_sent integer

この連絡先に送信されたメッセージの合計数。

total_msgs_received
items.total_msgs_received integer

この連絡先から受信されたメッセージの合計数。

response_count
items.response_count integer

この連絡先からの応答メッセージの合計数。

date_created_utc
items.date_created_utc string

連絡先が作成されたときのタイムスタンプ。

last_contact_date_utc
items.last_contact_date_utc string

この連絡先から最後のメッセージが送信、または受信されたときのタイムスタンプ。

message_id
items.last_message.message_id string

メッセージの ID。 この値は各メッセージに対して固有のものです。

body
items.last_message.body string

このメッセージのコンテンツ。

message_direction
items.last_message.message_direction string

R または S のいずれかの単数文字で、このメッセージが連絡先から受信されたか、連絡先に送信されたかをそれぞれ示します。

response_by_username
items.last_message.response_by_username string

このユーザーに最後にメッセージを送信した Text Request ユーザーのユーザー名。

message_timestamp_utc
items.last_message.message_timestamp_utc string

Text Request によってメッセージが送信、または受信されたときのタイムスタンプ。

delivery_status
items.last_message.delivery_status string

このメッセージの現在の状態。 これは、'送信中'、'配信済み'、'エラー'、または '送信' のいずれかです。

delivery_error
items.last_message.delivery_error string

このメッセージが配信されない原因となったエラー。 delivery_status が 'エラー' でない場合、この値は null になります。

mms_media
items.last_message.mms_media array of string

このメッセージの添付ファイルを指す URL のリスト。 すべての URL は、テキスト リクエストによって生成された URL になります。

指定された名前と電話番号で新しいダッシュボードを作成します

アカウントに新しいダッシュボードを作成します。 ダッシュボードが作成されると、管理者に変更に関するメールが送信され、ユーザーの割り当てを開始できます。 このエンドポイントは、プロビジョニングされた番号のダッシュボードを作成できます。 GET /dashboards/provisioning を使用して、特定の市外局番でプロビジョニングされた番号を検索できます。 電話番号が既に使用されている場合は、Bad Request 例外がスローされます。

パラメーター

名前 キー 必須 説明
名称
name string

ダッシュボードの名前。

電話番号
phone string

このダッシュボードに関連付けられたテキスト番号。

戻り値

名前 パス 説明
id
id integer

ダッシュボードの数値 ID。

名称
name string

ダッシュボードの名前。

電話番号
phone string

このダッシュボードに関連付けられたテキスト番号。

指定された支払いをキャンセルする

指定された支払いをキャンセルし、支払いがキャンセルされたことをユーザーに通知します。 支払いは編集できないため、キャンセルして新しい支払いを発行することが、支払いを修正する最善の方法です。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

支払いの ID
payment_id True integer

更新する支払いの数値 ID。

戻り値

名前 パス 説明
payment_id
payment_id integer

支払いの数値 ID。

request_date
request_date string

この支払いの最初のメッセージが送信キューに入れられたときのタイムスタンプ。

受信者
recipient string

支払い受信者の名前。 連絡先の電話番号に名前が関連付けられていない場合、これは null になる可能性があります。

description
description string

支払いの説明。 これは連絡先に表示されません。 これは、支払いに関するコンテキストのために内部ユーザーによってのみ使用されます。

customer_phone
customer_phone string

この支払いの送信先の連絡先の電話番号。

amount_requested
amount_requested float

この支払いで要求されたドル単位の金額。

is_past_due
is_past_due boolean

この支払いが要求日を過ぎているかどうか。

reminder_was_sent
reminder_was_sent boolean

この支払いに対してテキスト リマインダーが既に送信されているかどうか。

transaction_status
transaction_status string

authvia のトランザクションの状態。 この値は不明として開始します。

textrequest_payment_status
textrequest_payment_status string

Text Request のトランザクションの状態。 これは、Text Request アプリの支払いページに表示されるステータスを表します。 これは送信済みとして開始されます。

reference_number
reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

指定された支払いを支払うようユーザーに通知するフォローアップ テキストを送信する

指定された支払いを支払うよう連絡先にリマインダーを送信します。 メッセージの内容は自動生成されます。 スパムを避けるため、支払いごとに送信できるリマインダーは 1 つだけです

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

支払いの ID
payment_id True integer

更新する支払いの数値 ID。

戻り値

名前 パス 説明
payment_id
payment_id integer

支払いの数値 ID。

request_date
request_date string

この支払いの最初のメッセージが送信キューに入れられたときのタイムスタンプ。

受信者
recipient string

支払い受信者の名前。 連絡先の電話番号に名前が関連付けられていない場合、これは null になる可能性があります。

description
description string

支払いの説明。 これは連絡先に表示されません。 これは、支払いに関するコンテキストのために内部ユーザーによってのみ使用されます。

customer_phone
customer_phone string

この支払いの送信先の連絡先の電話番号。

amount_requested
amount_requested float

この支払いで要求されたドル単位の金額。

is_past_due
is_past_due boolean

この支払いが要求日を過ぎているかどうか。

reminder_was_sent
reminder_was_sent boolean

この支払いに対してテキスト リマインダーが既に送信されているかどうか。

transaction_status
transaction_status string

authvia のトランザクションの状態。 この値は不明として開始します。

textrequest_payment_status
textrequest_payment_status string

Text Request のトランザクションの状態。 これは、Text Request アプリの支払いページに表示されるステータスを表します。 これは送信済みとして開始されます。

reference_number
reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

指定された電話番号の連絡先にメッセージを送信します

メッセージを送信します (指定された電話番号にメッセージ履歴がない場合は、新しい会話を開始します)。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

メッセージへの電話番号
phone_number True string

メッセージを送信する連絡先の電話番号。

メッセージの本文
body string

送信するメッセージの内容。

送信者の名前
sender_name string

メッセージの送信者の名前。 これは、このメッセージを取得するときに TextRequest Web アプリと API に表示されます。

メッセージのステータスが更新されたときのコールバック URL
status_callback string

このメッセージのステータスが未配信から送信済み (またはエラー) になるたびに、Web アプリが POST コマンドでヒットする URL。

このメッセージにロケーション リクエストが含まれている場合は、ロケーション リクエストのコールバック URL
location_callback string

ユーザーが位置情報にアクセスして送信者との位置情報の共有を承認したときに、POST コマンドでヒットする位置情報コールバック URL。 リンクを含めるには、メッセージ本文に [Location Request] を追加します。 このコールバックは位置情報のリクエストには必要ありませんが、API には役立ちます。

このメッセージの MMS メディア添付ファイル
mms_media array of string

このメッセージの MMS メディア添付ファイルの配列。 添付ファイルは、投稿 /mms エンドポイント (このコネクタには含まれていません) から取得した URL でなければなりません。 外部添付リンクは受け付けません。

戻り値

名前 パス 説明
message_id
message_id string

メッセージの ID。 この値は各メッセージに対して固有のものです。

body
body string

このメッセージのコンテンツ。

message_direction
message_direction string

R または S のいずれかの単数文字で、このメッセージが連絡先から受信されたか、連絡先に送信されたかをそれぞれ示します。

response_by_username
response_by_username string

このユーザーに最後にメッセージを送信した Text Request ユーザーのユーザー名。

message_timestamp_utc
message_timestamp_utc string

Text Request によってメッセージが送信、または受信されたときのタイムスタンプ。

delivery_status
delivery_status string

このメッセージの現在の状態。 これは、'送信中'、'配信済み'、'エラー'、または '送信' のいずれかです。

delivery_error
delivery_error string

このメッセージが配信されない原因となったエラー。 delivery_status が 'エラー' でない場合、この値は null になります。

mms_media
mms_media array of string

このメッセージの添付ファイルを指す URL のリスト。 すべての URL は、テキスト リクエストによって生成された URL になります。

指定したダッシュボードを削除します

指定したダッシュボードを削除します。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

戻り値

返答
string

指定した電話番号の連絡先を削除します

このダッシュボードにこの電話番号の連絡先が存在しない場合、コンテンツは返されません。 連絡先が存在するが、メッセージ履歴がない場合、コンテンツは返されず、正常な状態コードは削除されたことを示します。 連絡先にメッセージ履歴がある場合は削除できず、Bad Request エラーが返されます。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

連絡先の電話番号
phone_number True string

削除する連絡先の電話番号。

戻り値

返答
string

指定した電話番号の連絡先を取得します

このダッシュボードにこの電話番号の連絡先が存在しない場合、コンテンツは返されず、エラーはスローされません。 指定されたダッシュボードのみ検索され、連絡先はダッシュボードごとに整理され、アカウント レベルで番号を検索することはできません。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

連絡先の電話番号
phone_number True string

取得する連絡先の電話番号。

戻り値

名前 パス 説明
phone_number
phone_number string

この連絡先の電話番号。

first_name
first_name string

この連絡先の名。

last_name string

この連絡先の姓。

display_name
display_name string

この連絡先の氏名。 これは、連絡先を表示するときに Web アプリに表示されるデフォルトの名前です。

is_suppressed
is_suppressed boolean

この連絡先との会話を抑制して、受信時にメッセージ キューの先頭にプッシュしないかどうか。

is_archived
is_archived boolean

この連絡先との会話をアーカイブするかどうか、したがって、会話のクエリを実行しても表示されません (デフォルトで)。

is_blocked
is_blocked boolean

この連絡先との会話をブロックするかどうか、したがって、受信も保存もされません。

suppressed_reason
suppressed_reason string

連絡を差し控える理由を説明するフレーズ。 is_suppressed が false の場合、これは null になります。

note
note string

連絡先を説明する短いフレーズ。 便宜上の使用。 これは連絡先に表示されることはありません。

groups
groups array of integer

この連絡先が属するグループを参照する整数 ID の配列。

contact_tags
contact_tags array of string

この連絡先に添付されたタグを参照する GUID の配列。

custom_fields
custom_fields array of object

この連絡先に定義されたカスタム フィールド ID と値の配列。

id
custom_fields.id string

カスタム フィールドを参照するガイド。

価値
custom_fields.value string

このカスタム フィールドのこの連絡先の値。

is_resolved
is_resolved boolean

この連絡先との現在の会話が解決されたかどうか。 この連絡先が新しいテキストを受信すると、これは false に設定されます。

first_contact_utc
first_contact_utc string

この連絡先に最初のメッセージが送信されたときのタイムスタンプ。

opted_out_utc
opted_out_utc string

この連絡先がメッセージの受信をオプトアウトしたときのタイムスタンプ。

last_msg_sent_utc
last_msg_sent_utc string

この連絡先に最後のメッセージが送信されたときのタイムスタンプ。

last_msg_received_utc
last_msg_received_utc string

この連絡先から最後のメッセージが受信されたときのタイムスタンプ。

total_msgs_sent
total_msgs_sent integer

この連絡先に送信されたメッセージの合計数。

total_msgs_received
total_msgs_received integer

この連絡先から受信されたメッセージの合計数。

response_count
response_count integer

この連絡先からの応答メッセージの合計数。

date_created_utc
date_created_utc string

連絡先が作成されたときのタイムスタンプ。

last_contact_date_utc
last_contact_date_utc string

この連絡先から最後のメッセージが送信、または受信されたときのタイムスタンプ。

message_id
last_message.message_id string

メッセージの ID。 この値は各メッセージに対して固有のものです。

body
last_message.body string

このメッセージのコンテンツ。

message_direction
last_message.message_direction string

R または S のいずれかの単数文字で、このメッセージが連絡先から受信されたか、連絡先に送信されたかをそれぞれ示します。

response_by_username
last_message.response_by_username string

このユーザーに最後にメッセージを送信した Text Request ユーザーのユーザー名。

message_timestamp_utc
last_message.message_timestamp_utc string

Text Request によってメッセージが送信、または受信されたときのタイムスタンプ。

delivery_status
last_message.delivery_status string

このメッセージの現在の状態。 これは、'送信中'、'配信済み'、'エラー'、または '送信' のいずれかです。

delivery_error
last_message.delivery_error string

このメッセージが配信されない原因となったエラー。 delivery_status が 'エラー' でない場合、この値は null になります。

mms_media
last_message.mms_media array of string

このメッセージの添付ファイルを指す URL のリスト。 すべての URL は、テキスト リクエストによって生成された URL になります。

支払いを支払い済としてマークする

支払いを "支払い済" としてクローズします。 この エンドポイント は、支払いリクエスト ポータル以外の手段で支払いが行われる場合に使用します。 これにより支払いが終了し、その支払い額が統計に追加されます。 このエンドポイントは、テキスト リクエストを通じて送信された支払いポータルを通じて支払われる支払いには必要ありません。これにより、支払いが自動的に支払い済みとしてマークされます。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

支払いの ID
payment_id True integer

更新する支払いの数値 ID。

戻り値

名前 パス 説明
payment_id
payment_id integer

支払いの数値 ID。

request_date
request_date string

この支払いの最初のメッセージが送信キューに入れられたときのタイムスタンプ。

受信者
recipient string

支払い受信者の名前。 連絡先の電話番号に名前が関連付けられていない場合、これは null になる可能性があります。

description
description string

支払いの説明。 これは連絡先に表示されません。 これは、支払いに関するコンテキストのために内部ユーザーによってのみ使用されます。

customer_phone
customer_phone string

この支払いの送信先の連絡先の電話番号。

amount_requested
amount_requested float

この支払いで要求されたドル単位の金額。

is_past_due
is_past_due boolean

この支払いが要求日を過ぎているかどうか。

reminder_was_sent
reminder_was_sent boolean

この支払いに対してテキスト リマインダーが既に送信されているかどうか。

transaction_status
transaction_status string

authvia のトランザクションの状態。 この値は不明として開始します。

textrequest_payment_status
textrequest_payment_status string

Text Request のトランザクションの状態。 これは、Text Request アプリの支払いページに表示されるステータスを表します。 これは送信済みとして開始されます。

reference_number
reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

新しい支払いの作成

指定された連絡先への指定されたメッセージで新しい支払いを作成します。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

支払いの説明
description string

支払い方法の説明。 説明は連絡先には表示されず、支払いに関するコンテキストのために内部ユーザーによってのみ使用されます。

受信者の電話番号
customer_phone string

送信されるこの支払いの連絡先の電話番号。

要求された金額 (ドル)
amount_requested float

この支払いで要求されたドル単位の金額。

支払いメッセージ本文のテキスト
message string

支払いリンクとともに連絡先に送信するメッセージ テキスト。

支払いの参照文字列
reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

戻り値

名前 パス 説明
payment_id
payment_id integer

支払いの数値 ID。

request_date
request_date string

この支払いの最初のメッセージが送信キューに入れられたときのタイムスタンプ。

受信者
recipient string

支払い受信者の名前。 連絡先の電話番号に名前が関連付けられていない場合、これは null になる可能性があります。

description
description string

支払いの説明。 これは連絡先に表示されません。 これは、支払いに関するコンテキストのために内部ユーザーによってのみ使用されます。

customer_phone
customer_phone string

この支払いの送信先の連絡先の電話番号。

amount_requested
amount_requested float

この支払いで要求されたドル単位の金額。

is_past_due
is_past_due boolean

この支払いが要求日を過ぎているかどうか。

reminder_was_sent
reminder_was_sent boolean

この支払いに対してテキスト リマインダーが既に送信されているかどうか。

transaction_status
transaction_status string

authvia のトランザクションの状態。 この値は不明として開始します。

textrequest_payment_status
textrequest_payment_status string

Text Request のトランザクションの状態。 これは、Text Request アプリの支払いページに表示されるステータスを表します。 これは送信済みとして開始されます。

reference_number
reference_number string

支払いをすばやく見つけるために使用できる、支払いの作成時に定義されたユーザー定義の ID。 参照番号は一意ではありません。多くの支払いが同じ参照を持つことができます。

新規グループの作成

提供された名前を持つ新規グループを作成する。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

Group name
name string

グループの新しい名前。

グループ ノート
notes string

グループを説明する短いフレーズ。 便宜上の使用。

戻り値

名前 パス 説明
id
id integer

グループの数値 ID。

group_member_count
group_member_count integer

グループ内のメンバーの数。

is_keyword
is_keyword boolean

このグループがキーワード グループかどうか。 このようなグループは、ユーザーがキーワードを設定すると自動生成されます。 連絡先は、登録時に自動的に追加されます。

名称
name string

このグループの名前。

メモ
notes string

このグループに関するメモ。

last_message_sent_utc
last_message_sent_utc string

最後のグループ メッセージがこのグループに送信されたときのタイムスタンプ。

特定のダッシュボード名を更新する

ダッシュボードを更新します。 これにより、ダッシュボードの電話番号が変更されることはありません。 別のダッシュボードの連絡先で新しい番号が必要な場合は、POST で新しいダッシュボードを作成し、一括エクスポート/インポートで連絡先を追加する必要があります。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

ダッシュボード名
name string

ダッシュボードの新しい名前

戻り値

名前 パス 説明
id
id integer

ダッシュボードの数値 ID。

名称
name string

ダッシュボードの名前。

電話番号
phone string

このダッシュボードに関連付けられたテキスト番号。

連絡先の一括更新

指定されたダッシュボードのみに連絡先が追加されます。連絡先はダッシュボードごとに整理されており、アカウント レベルで番号を検索することはできません。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

連絡先の電話番号
phone_number string

作成または更新する連絡先の電話番号。

連絡先の名
first_name string

新しい連絡先の名。

連絡先の姓
last_name string

新しい連絡先の姓。

連絡先の氏名
display_name string

新しい連絡先の氏名。 これは、連絡先を表示するときに Web アプリに表示されるデフォルトの名前です。

この連絡先からのメッセージを非表示にするかどうか
is_suppressed boolean

この連絡先との会話を抑制し、受信時にメッセージ キューの先頭にプッシュしないかどうかを決定します。

この連絡先からのメッセージをアーカイブするかどうか
is_archived boolean

この連絡先との会話をアーカイブするかどうかを決定します。したがって、会話のクエリを実行しても表示されません (デフォルトで)。

この連絡先からのメッセージをブロックするかどうか
is_blocked boolean

この連絡先との会話をブロックするかどうかを決定します。したがって、受信も保存もされません。

この連絡を差し控える理由
suppressed_reason string

連絡を差し控える理由を説明するフレーズ。

連絡先メモ
note string

連絡先を説明する短いフレーズ。 便宜上の使用。 これは連絡先に表示されることはありません。

連絡先グループ
groups array of integer

この連絡先が属する予定のグループを参照する整数 ID の配列。

連絡先タグ
contact_tags array of string

この連絡先に添付されたタグを参照する GUID の配列。

カスタム フィールド ID
id string

カスタム フィールドを参照するガイド。

カスタム フィールド値
value string

このカスタム フィールドのこの連絡先の値。

この連絡先との現在の会話が解決されたかどうか
is_resolved boolean

この連絡先との現在の会話が解決されたかどうかを決定します。 この連絡先が新しいテキストを受信すると、これは false に設定されます。

戻り値

名前 パス 説明
array of object
phone_number
phone_number string

この連絡先の電話番号。

first_name
first_name string

この連絡先の名。

last_name string

この連絡先の姓。

display_name
display_name string

この連絡先の氏名。 これは、連絡先を表示するときに Web アプリに表示されるデフォルトの名前です。

is_suppressed
is_suppressed boolean

この連絡先との会話を抑制して、受信時にメッセージ キューの先頭にプッシュしないかどうか。

is_archived
is_archived boolean

この連絡先との会話をアーカイブするかどうか、したがって、会話のクエリを実行しても表示されません (デフォルトで)。

is_blocked
is_blocked boolean

この連絡先との会話をブロックするかどうか、したがって、受信も保存もされません。

suppressed_reason
suppressed_reason string

連絡を差し控える理由を説明するフレーズ。 is_suppressed が false の場合、これは null になります。

note
note string

連絡先を説明する短いフレーズ。 便宜上の使用。 これは連絡先に表示されることはありません。

groups
groups array of integer

この連絡先が属するグループを参照する整数 ID の配列。

contact_tags
contact_tags array of string

この連絡先に添付されたタグを参照する GUID の配列。

custom_fields
custom_fields array of object

この連絡先に定義されたカスタム フィールド ID と値の配列。

id
custom_fields.id string

カスタム フィールドを参照するガイド。

価値
custom_fields.value string

このカスタム フィールドのこの連絡先の値。

is_resolved
is_resolved boolean

この連絡先との現在の会話が解決されたかどうか。 この連絡先が新しいテキストを受信すると、これは false に設定されます。

first_contact_utc
first_contact_utc string

この連絡先に最初のメッセージが送信されたときのタイムスタンプ。

opted_out_utc
opted_out_utc string

この連絡先がメッセージの受信をオプトアウトしたときのタイムスタンプ。

last_msg_sent_utc
last_msg_sent_utc string

この連絡先に最後のメッセージが送信されたときのタイムスタンプ。

last_msg_received_utc
last_msg_received_utc string

この連絡先から最後のメッセージが受信されたときのタイムスタンプ。

total_msgs_sent
total_msgs_sent integer

この連絡先に送信されたメッセージの合計数。

total_msgs_received
total_msgs_received integer

この連絡先から受信されたメッセージの合計数。

response_count
response_count integer

この連絡先からの応答メッセージの合計数。

date_created_utc
date_created_utc string

連絡先が作成されたときのタイムスタンプ。

last_contact_date_utc
last_contact_date_utc string

この連絡先から最後のメッセージが送信、または受信されたときのタイムスタンプ。

message_id
last_message.message_id string

メッセージの ID。 この値は各メッセージに対して固有のものです。

body
last_message.body string

このメッセージのコンテンツ。

message_direction
last_message.message_direction string

R または S のいずれかの単数文字で、このメッセージが連絡先から受信されたか、連絡先に送信されたかをそれぞれ示します。

response_by_username
last_message.response_by_username string

このユーザーに最後にメッセージを送信した Text Request ユーザーのユーザー名。

message_timestamp_utc
last_message.message_timestamp_utc string

Text Request によってメッセージが送信、または受信されたときのタイムスタンプ。

delivery_status
last_message.delivery_status string

このメッセージの現在の状態。 これは、'送信中'、'配信済み'、'エラー'、または '送信' のいずれかです。

delivery_error
last_message.delivery_error string

このメッセージが配信されない原因となったエラー。 delivery_status が 'エラー' でない場合、この値は null になります。

mms_media
last_message.mms_media array of string

このメッセージの添付ファイルを指す URL のリスト。 すべての URL は、テキスト リクエストによって生成された URL になります。

連絡先の電話番号で会話のメッセージを取得する

指定されたダッシュボードと電話番号の間の会話を取得します。

パラメーター

名前 キー 必須 説明
取得するページ番号
page True integer

取得するエンティティのページ。 値を取得する場合、page_size で定義されたページあたりの最大サイズがあります。 ページが最後のページより大きい場合、空の配列が返されます。

ページごとに取得する各エンティティの量
page_size True integer

取得する各ページのサイズ。 値を取得する場合、これはページごとの最大サイズであり、後続のページへのアクセスはページ パラメータによって行われます。

この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

検索する連絡先の電話番号
phone_number True string

メッセージを取得する連絡先の電話番号。

戻り値

名前 パス 説明
page
meta.page integer

取得するエンティティのページ。 このページ内のエンティティの量は、page_size によって定義されます。

page_size
meta.page_size integer

このページで取得したエンティティの数。

total_items
meta.total_items integer

ページのサイズや数に関係なく、データベースで使用できるエンティティの数。 他のページを表示するには、リクエストでページ番号を変更します。

アイテム
items array of object

テキスト リクエストから取得したメッセージ エンティティのリスト。

message_id
items.message_id string

メッセージの ID。 この値は各メッセージに対して固有のものです。

body
items.body string

このメッセージのコンテンツ。

message_direction
items.message_direction string

R または S のいずれかの単数文字で、このメッセージが連絡先から受信されたか、連絡先に送信されたかをそれぞれ示します。

response_by_username
items.response_by_username string

このユーザーに最後にメッセージを送信した Text Request ユーザーのユーザー名。

message_timestamp_utc
items.message_timestamp_utc string

Text Request によってメッセージが送信、または受信されたときのタイムスタンプ。

delivery_status
items.delivery_status string

このメッセージの現在の状態。 これは、'送信中'、'配信済み'、'エラー'、または '送信' のいずれかです。

delivery_error
items.delivery_error string

このメッセージが配信されない原因となったエラー。 delivery_status が 'エラー' でない場合、この値は null になります。

mms_media
items.mms_media array of string

このメッセージの添付ファイルを指す URL のリスト。 すべての URL は、テキスト リクエストによって生成された URL になります。

連絡先を作成または更新する

連絡先を作成または更新します (指定された電話番号の連絡先が既に存在するかどうかによって異なります)。

パラメーター

名前 キー 必須 説明
この呼び出しを行うダッシュボードの ID
dashboard_id True integer

作業する電話番号ダッシュボード。 1 つのアカウントに、顧客のさまざまな電話回線を表す複数のダッシュボードを含めることができます。

連絡先の電話番号
phone_number True string

作成または更新する連絡先の電話番号。

連絡先の名
first_name string

新しい連絡先の名。

連絡先の姓
last_name string

新しい連絡先の姓。

連絡先の氏名
display_name string

新しい連絡先の氏名。 これは、連絡先を表示するときに Web アプリに表示されるデフォルトの名前です。

この連絡先からのメッセージを非表示にするかどうか
is_suppressed boolean

この連絡先との会話を抑制し、受信時にメッセージ キューの先頭にプッシュしないかどうかを決定します。

この連絡先からのメッセージをアーカイブするかどうか
is_archived boolean

この連絡先との会話をアーカイブするかどうかを決定します。したがって、会話のクエリを実行しても表示されません (デフォルトで)。

この連絡先からのメッセージをブロックするかどうか
is_blocked boolean

この連絡先との会話をブロックするかどうかを決定します。したがって、受信も保存もされません。

この連絡を差し控える理由
suppressed_reason string

連絡を差し控える理由を説明するフレーズ。

連絡先メモ
note string

連絡先を説明する短いフレーズ。 便宜上の使用。 これは連絡先に表示されることはありません。

連絡先グループ
groups array of integer

この連絡先が属する予定のグループを参照する整数 ID の配列。

連絡先タグ
contact_tags array of string

この連絡先に添付されたタグを参照する GUID の配列。

カスタム フィールド ID
id string

カスタム フィールドを参照するガイド。

カスタム フィールド値
value string

このカスタム フィールドのこの連絡先の値。

この連絡先との現在の会話が解決されたかどうか
is_resolved boolean

この連絡先との現在の会話が解決されたかどうかを決定します。 この連絡先が新しいテキストを受信すると、これは false に設定されます。

戻り値

名前 パス 説明
phone_number
phone_number string

この連絡先の電話番号。

first_name
first_name string

この連絡先の名。

last_name string

この連絡先の姓。

display_name
display_name string

この連絡先の氏名。 これは、連絡先を表示するときに Web アプリに表示されるデフォルトの名前です。

is_suppressed
is_suppressed boolean

この連絡先との会話を抑制して、受信時にメッセージ キューの先頭にプッシュしないかどうか。

is_archived
is_archived boolean

この連絡先との会話をアーカイブするかどうか、したがって、会話のクエリを実行しても表示されません (デフォルトで)。

is_blocked
is_blocked boolean

この連絡先との会話をブロックするかどうか、したがって、受信も保存もされません。

suppressed_reason
suppressed_reason string

連絡を差し控える理由を説明するフレーズ。 is_suppressed が false の場合、これは null になります。

note
note string

連絡先を説明する短いフレーズ。 便宜上の使用。 これは連絡先に表示されることはありません。

groups
groups array of integer

この連絡先が属するグループを参照する整数 ID の配列。

contact_tags
contact_tags array of string

この連絡先に添付されたタグを参照する GUID の配列。

custom_fields
custom_fields array of object

この連絡先に定義されたカスタム フィールド ID と値の配列。

id
custom_fields.id string

カスタム フィールドを参照するガイド。

価値
custom_fields.value string

このカスタム フィールドのこの連絡先の値。

is_resolved
is_resolved boolean

この連絡先との現在の会話が解決されたかどうか。 この連絡先が新しいテキストを受信すると、これは false に設定されます。

first_contact_utc
first_contact_utc string

この連絡先に最初のメッセージが送信されたときのタイムスタンプ。

opted_out_utc
opted_out_utc string

この連絡先がメッセージの受信をオプトアウトしたときのタイムスタンプ。

last_msg_sent_utc
last_msg_sent_utc string

この連絡先に最後のメッセージが送信されたときのタイムスタンプ。

last_msg_received_utc
last_msg_received_utc string

この連絡先から最後のメッセージが受信されたときのタイムスタンプ。

total_msgs_sent
total_msgs_sent integer

この連絡先に送信されたメッセージの合計数。

total_msgs_received
total_msgs_received integer

この連絡先から受信されたメッセージの合計数。

response_count
response_count integer

この連絡先からの応答メッセージの合計数。

date_created_utc
date_created_utc string

連絡先が作成されたときのタイムスタンプ。

last_contact_date_utc
last_contact_date_utc string

この連絡先から最後のメッセージが送信、または受信されたときのタイムスタンプ。

message_id
last_message.message_id string

メッセージの ID。 この値は各メッセージに対して固有のものです。

body
last_message.body string

このメッセージのコンテンツ。

message_direction
last_message.message_direction string

R または S のいずれかの単数文字で、このメッセージが連絡先から受信されたか、連絡先に送信されたかをそれぞれ示します。

response_by_username
last_message.response_by_username string

このユーザーに最後にメッセージを送信した Text Request ユーザーのユーザー名。

message_timestamp_utc
last_message.message_timestamp_utc string

Text Request によってメッセージが送信、または受信されたときのタイムスタンプ。

delivery_status
last_message.delivery_status string

このメッセージの現在の状態。 これは、'送信中'、'配信済み'、'エラー'、または '送信' のいずれかです。

delivery_error
last_message.delivery_error string

このメッセージが配信されない原因となったエラー。 delivery_status が 'エラー' でない場合、この値は null になります。

mms_media
last_message.mms_media array of string

このメッセージの添付ファイルを指す URL のリスト。 すべての URL は、テキスト リクエストによって生成された URL になります。

定義

string

これは基本的なデータ型 '文字列' です。