更新:查看版本資訊瞭解新功能和產品更新。

建立代理程式來管理品牌

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

代理程式是指品牌在裝置上與裝置互動的對話表示法 (以及代表該表示法的所有基礎架構)。

已註冊合作夥伴可讓您建立「已驗證簡訊」代理程式,讓您使用 Verified SMS API 並定義與使用者對話中顯示的品牌宣傳資訊。使用已驗證簡訊儲存訊息雜湊時,請呼叫 API,並將訊息與特定代理程式建立關聯。

舉例來說,如要代表品牌 Growing Tree Bank 傳送已驗證訊息,請使用已驗證簡訊來建立 Growing Tree Bank 代理程式。您會使用合作夥伴憑證來驗證已驗證簡訊的 API 呼叫,並將訊息雜湊儲存為 Growing Tree Bank,代理程式會在與使用者對話中顯示 Growing Tree Bank 的品牌宣傳資訊。

含有品牌資訊的已驗證簡訊

如果您管理多個品牌,請為已驗證的品牌為每個品牌建立服務專員。

本地化

驗證簡訊代理程式可以在多個國家/地區提供「寄件者 ID」,但代理程式的品牌宣傳資訊 (包括代理程式名稱和說明) 不會本地化。

若要為代理程式取得本地化品牌宣傳資訊,請針對傳送訊息的各種語言建立代理程式。將代理程式顯示名稱和說明本地化,但請為各個代理程式指定相同的本地化品牌名稱。如果每種語言都有專屬的寄件者 ID,請務必將這些 ID 與正確的本地化代理程式建立關聯。

根據預設,您每次建立服務專員時,已驗證簡訊功能都會與品牌聯絡,以便執行品牌宣傳驗證作業。如果您預計建立多個本地化代理程式,並希望 Google 一次聯絡品牌進行大量品牌宣傳驗證,請與我們聯絡

建立代理程式

如要建立代理程式,您必須收集並提交與品牌相關的資訊,以及您希望使用者看見代理程式的方式。

必要條件

您必須先收集一些資訊才能建立代理程式:

  • 公司行號名稱
  • 品牌網站
  • 代理程式名稱,也就是您希望向使用者顯示的對話 (最多 100 個半形字元)
  • 服務專員說明
  • 以檔案或公開網址的形式顯示代理程式標誌 (JPEG 或 PNG)

    對話中標誌會以 224 像素的直徑顯示。標誌應以圓形呈現。

  • 各寄件者 ID 所營運國家/地區的專屬非共用寄件者 ID (簡短、長碼和英數字元代碼) 和 ISO 3166 Alpha-2 國家/地區代碼清單

  • 代理人的品牌員工名稱與電子郵件地址,可用來代表您與品牌的商業關係,以及您有權代表品牌

建立代理程式

收集完資訊後,即可開始建立代理程式。

  1. 開啟 Business Communications Developer Console,然後使用已驗證簡訊 Google 帳戶登入。
  2. 按一下「建立代理程式」
  3. 如果系統提示您「代理程式類型」,請選擇「已驗證簡訊」
  4. 輸入「品牌名稱」和「代理程式名稱」的值。
  5. 在「服務專員」標誌中上傳標誌,或指定可公開存取的網址。

  6. 點選「下一步」。

  7. 輸入代理程式的寄件者 ID 和相關國家/地區,然後點選「下一步」

  8. 請輸入品牌聯絡人、品牌網站本身和網站值。

  9. 按一下「完成設定」。

你的服務專員出現在代理程式清單,但無法使用。在品牌核准您的服務專員資訊後,服務專員就能開始使用。

代理程式可供使用後,您必須建立私密/公開金鑰組,然後透過開發人員控制台更新代理程式的公開金鑰

更新服務專員資訊

服務專員的資訊通過驗證後,您可以更新寄件者 ID更新代理程式的公開金鑰

如要更新其他代理程式詳細資料,請與我們聯絡。找出要更新的代理程式和資訊,包括新的值。提交新資訊後,最多可能需要 3 個工作天才能更新服務專員資訊。

刪除代理程式

刪除代理程式時,您可以透過 Business Communications API 執行 DELETE 要求。如果您多次嘗試驗證代理程式,則刪除要求會失敗。如要刪除已驗證或嘗試驗證的代理程式,請與我們聯絡

如要刪除代理程式,請執行下列指令。將 BRAND_IDAGENT_ID 替換成代理程式 name 的專屬值。


# This code deletes an agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/delete

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X DELETE "https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"

如需格式設定和值選項,請參閱 brands.agents.delete

刪除品牌

刪除品牌時,系統會使用 Business Communications API 執行「刪除」要求。如果您有一或多個與品牌相關聯的代理程式或位置,即使這些代理程式屬於不同的產品,刪除要求也會失敗。

如要刪除品牌,請執行下列指令。將 BRAND_ID 替換成品牌 name 的專屬值。


# This code deletes a brand.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands/delete

# Replace the __BRAND_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X DELETE "https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"

如需格式設定和值選項,請參閱 brands.delete

後續步驟

開始透過已驗證簡訊儲存訊息雜湊之前的注意事項:

完成上述步驟後,您就可以傳送已驗證訊息