tyntec WhatsApp Business

tyntec Conversations API を使用して 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)

お問い合わせ先
件名	tyntec のサポート
[URL]	https://www.tyntec.com/get-help-support
メール	support@tyntec.com

Connector Metadata
発行者	tyntec GmbH
Web サイト	https://www.tyntec.com
プライバシー ポリシー	https://www.tyntec.com/data-privacy-statement
カテゴリー	通信; コマース

“tyntec WhatsApp Business” コネクタは、一方向 WhatsApp チャネルを有効にすることで、Power Apps、Power Automation、または Azure Logic Apps の通信機能を強化します。 tyntec Conversations API を使用して、通知、アラート、メモ、またはカスタマー エンゲージメント資料を送信できます。

前提条件

続行するには、次のものが必要です。

• カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン
• tyntec API キー
• tyntec 提供の WhatsApp ビジネス アカウント
• WhatsApp によって承認された WhatsApp メッセージ テンプレート

API キーを取得する方法は?

1. サインアップ/ログイン を tyntec アカウントに登録します
2. API 設定 をクリックする
3. API 設定で、新しい API キー をクリックします
4. 新しく割り当てられた API キーをコピーします

WhatsApp ビジネス アカウント番号を取得する方法は?

1. ガイドライン [tyntec ウェブサイト上](https://www.tyntec.com/docs/ whatsapp-business-api-account-information-get-started#toc--setup-your-whatsapp-business-account-waba-) に従います

WhatsApp メッセージ テンプレートを取得する方法は?

1. tyntec の Web サイトで ガイドラインに従ってください

接続の作成

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

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

既定

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

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

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

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

調整制限

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

アクション

WABA 番号を検証する	WABA 番号を検証する
WhatsApp テンプレート テキスト メッセージを送信	WhatsApp テンプレート テキスト メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。
WhatsApp テンプレート ドキュメント メッセージの送信	WhatsApp テンプレート ドキュメント画像を送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。
Whatsapp テンプレート ビデオ メッセージを送信する	WhatsApp テンプレート ビデオ メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。
WhatsApp テンプレート メッセージを送信	画像付きの WhatsApp テンプレート メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。
WhatsApp テンプレート メッセージを送信 (非推奨) [非推奨]	WhatsApp テンプレート メッセージを送信します (非推奨)
WhatsApp テンプレートのクイック返信を送信	このアクションは WhatsApp テンプレートをクイック返信で送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。
WhatsApp テンプレート位置メッセージを送信	WhatsApp テンプレート位置メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。
WhatsApp テンプレート動的 URL ボタンを送信	WhatsApp テンプレート動的 URL ボタンを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。
Whatsapp 自由形式の連絡先メッセージを送信する	WhatsApp経由で連絡先メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式クイック返信を送信	WhatsApp クイック返信を送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式ステッカー メッセージの送信	WhatsApp ステッカー メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式ドキュメント メッセージの送信	WhatsApp 自由形式ドキュメント メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式ビデオ メッセージの送信	WhatsApp 自由形式ビデオ メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式メッセージ (非推奨) [非推奨]	自由形式のメッセージを送信する (非推奨)
WhatsApp 自由形式メッセージの送信	WhatsApp を介して自由形式テキスト メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)。
WhatsApp 自由形式リスト メッセージの送信	WhatsApp リスト メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式位置メッセージの送信	WhatsApp 位置メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式単一製品の送信	WhatsApp 単一製品メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
WhatsApp 自由形式製品リストの送信	WhatsApp 製品リストを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
ステータスの確認	メッセージのステータスを確認
状態の確認 (非推奨) [非推奨]	メッセージの状態を確認 (非推奨)
自由形式の画像メッセージを送信する	画像なしのメッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)
自由形式の音声メッセージを送信する	無料フォーム音声メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

WABA 番号を検証する

操作 ID:

TestPhoneNumber

WABA 番号を検証する

パラメーター

名前	キー	必須	型	説明
WhatsAppBusinessNumber	whatsAppBusinessNumber	True	string	検証用 WABA

戻り値

名前	パス	型	説明
phoneNumber	phoneNumber	string	番号
displayPhoneNumber	displayPhoneNumber	string	電話番号の表示したバージョン
verifiedName	verifiedName	string	検証済みの名前
qualityRating	qualityRating	string	自分の品質評価
ステータス	status	string	ステータス
whatsAppAccountId	whatsAppAccountId	string	WhatsApp アカウント ID
accountName	managedBy.accountName	string	自分のアカウント名
accountName	messagingVia.accountName	string	メッセージング アカウント名
messagingTier	messagingTier	string	自分のメッセージング階層
score	qualityScore.score	string	スコア

WhatsApp テンプレート テキスト メッセージを送信

操作 ID:

SendWhatsAppTemplateText

WhatsApp テンプレート テキスト メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
templateId	templateId		string	templateId
templateLanguage	templateLanguage		string	templateLanguage
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp テンプレート ドキュメント メッセージの送信

操作 ID:

SendWhatsAppTemplateDocument

WhatsApp テンプレート ドキュメント画像を送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
templateId	templateId		string	templateId
templateLanguage	templateLanguage		string	templateLanguage
タイプ	type		string	タイプ
url	url		string	url
タイプ	type		string	タイプ
text	text		string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

Whatsapp テンプレート ビデオ メッセージを送信する

操作 ID:

SendWhatsAppTemplateVideo

WhatsApp テンプレート ビデオ メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
channel	channel		string	channel
contentType	contentType		string	contentType
templateId	templateId		string	templateId
templateLanguage	templateLanguage		string	templateLanguage
タイプ	type		string	タイプ
url	url		string	url
タイプ	type		string	タイプ
text	text		string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp テンプレート メッセージを送信

操作 ID:

SendWhatsAppTemplateImage

画像付きの WhatsApp テンプレート メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
templateId	templateId		string	templateId
templateLanguage	templateLanguage		string	templateLanguage
タイプ	type		string	タイプ
url	url		string	url
text	text		string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp テンプレート メッセージを送信 (非推奨) [非推奨]

操作 ID:

SendWhatsApp

WhatsApp テンプレート メッセージを送信します (非推奨)

パラメーター

名前	キー	必須	型	説明
送信先	to	True	string	受信者の電話番号
channels	channels	True	array of string	channels
送信元	from	True	string	WhatsApp ビジネス アカウント番号
templateId	templateId	True	string	テンプレート ID
language-policy	policy	True	string	言語ポリシー
language-code	code	True	string	言語コード
タイプ	type	True	string	タイプ
タイプ	type		string	パラメーターの種類
SubType	subType		string	呼び出しボタンに使用
url	url		string	url
タイプ	type		string	使用されているメディアの種類
ファイル名	filename		string	ファイル名
text	text		string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId

WhatsApp テンプレートのクイック返信を送信

操作 ID:

SendWhatsAppTemplateQuickReply

このアクションは WhatsApp テンプレートをクイック返信で送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
templateId	templateId		string	templateId
templateLanguage	templateLanguage		string	templateLanguage
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
index	index		integer	index
ペイロード	payload		string	ペイロード

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp テンプレート位置メッセージを送信

操作 ID:

SendWhatsAppTemplateLocation

WhatsApp テンプレート位置メッセージを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
templateId	templateId		string	templateId
templateLanguage	templateLanguage		string	templateLanguage
緯度	longitude		float	緯度
緯度	latitude		float	緯度
名称	name		string	名称
address	address		string	address
タイプ	type		string	タイプ
text	text		string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp テンプレート動的 URL ボタンを送信

操作 ID:

SendWhatsAppTemplateDynamicButton

WhatsApp テンプレート動的 URL ボタンを送信します。 いつでも使用可能です。 登録済みのテンプレートが必要です。

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
templateId	templateId		string	templateId
templateLanguage	templateLanguage		string	templateLanguage
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
index	index		integer	index
text	text		string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

Whatsapp 自由形式の連絡先メッセージを送信する

操作 ID:

SendWhatsAppContact

WhatsApp経由で連絡先メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
市	city		string	市
国	country		string	国
countryCode	countryCode		string	countryCode
street	street		string	street
タイプ	type		string	タイプ
郵便番号	zip		string	郵便番号
formattedName	formattedName		string	formattedName
lastName	lastName		string	lastName

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式クイック返信を送信

操作 ID:

SendWhatsAppQuickReply

WhatsApp クイック返信を送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
ペイロード	payload		string	ペイロード
肩書き	title		string	肩書き

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式ステッカー メッセージの送信

操作 ID:

SendWhatsAppSticker

WhatsApp ステッカー メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
url	url		string	url

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式ドキュメント メッセージの送信

操作 ID:

SendWhatsAppDocument

WhatsApp 自由形式ドキュメント メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
url	url		string	url
caption	caption		string	caption
ファイル名	filename		string	ファイル名

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式ビデオ メッセージの送信

操作 ID:

SendWhatsAppVideo

WhatsApp 自由形式ビデオ メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
url	url		string	url
caption	caption		string	caption

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式メッセージ (非推奨) [非推奨]

操作 ID:

SendFreeformMessage

自由形式のメッセージを送信する (非推奨)

パラメーター

名前	キー	必須	型	説明
送信先	to		string	送信先
channels	channels	True	array of string	channels
送信元	from		string	送信元
タイプ	type		string	タイプ
url	url		string	url
caption	caption		string	caption
contentType	contentType		string	contentType
テキスト	text		string	テキスト

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId

WhatsApp 自由形式メッセージの送信

操作 ID:

SendWhatsAppText

WhatsApp を介して自由形式テキスト メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)。

パラメーター

名前	キー	必須	型	説明
送信元	from	True	string	送信元
送信先	to	True	string	送信先
text	text	True	string	text

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式リスト メッセージの送信

操作 ID:

SendWhatsAppList

WhatsApp リスト メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
肩書き	title		string	肩書き
肩書き	title		string	肩書き
ペイロード	payload		string	ペイロード
肩書き	title		string	肩書き
description	description		string	description

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式位置メッセージの送信

操作 ID:

SendWhatsAppLocation

WhatsApp 位置メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
緯度	longitude		float	緯度
緯度	latitude		float	緯度
名称	name		string	名称
address	address		string	address

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式単一製品の送信

操作 ID:

SendWhatsAppProduct

WhatsApp 単一製品メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
catalogId	catalogId		string	catalogId
productId	productId		string	productId

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

WhatsApp 自由形式製品リストの送信

操作 ID:

SendWhatsAppProductList

WhatsApp 製品リストを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
タイプ	type		string	タイプ
text	text		string	text
catalogId	catalogId		string	catalogId
productId	productId		string	productId

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

ステータスの確認

操作 ID:

StatusCheckV3

メッセージのステータスを確認

パラメーター

名前	キー	必須	型	説明
メッセージ ID	messageId	True	string	メッセージ ID

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
ステータス	status	string	ステータス
timestamp	timestamp	string	timestamp

状態の確認 (非推奨) [非推奨]

操作 ID:

StatusCheck

メッセージの状態を確認 (非推奨)

パラメーター

名前	キー	必須	型	説明
メッセージ ID	id	True	string	messageId

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
deliveryChannel	deliveryChannel	string	deliveryChannel
ステータス	status	string	ステータス
timestamp	timestamp	string	timestamp

自由形式の画像メッセージを送信する

操作 ID:

SendsWhatsAppImage

画像なしのメッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
url	url		string	url
caption	caption		string	caption

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

自由形式の音声メッセージを送信する

操作 ID:

SendWhatsAppAudio

無料フォーム音声メッセージを送信します。 サポート期間中のみ使用可能 (お客様からの最後のメッセージから 24 時間後)

パラメーター

名前	キー	必須	型	説明
送信元	from		string	送信元
送信先	to		string	送信先
url	url		string	url

戻り値

名前	パス	型	説明
messageId	messageId	string	messageId
timestamp	timestamp	string	timestamp

トリガー

受信メッセージ	受信メッセージのトリガー
受信メッセージ (非推奨) [非推奨]	受信メッセージのトリガー (非推奨)

受信メッセージ

操作 ID:

IncomingV2

受信メッセージのトリガー

パラメーター

名前	キー	必須	型	説明
WhatsApp ビジネス アカウント番号	WABA	True	string	WhatsApp ビジネス アカウント番号

受信メッセージ (非推奨) [非推奨]

操作 ID:

Incoming

受信メッセージのトリガー (非推奨)