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

建立代理程式來管理品牌

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

代理程式是品牌與使用者在裝置上互動過的品牌 (以及代表該技術的所有基礎架構)。

已註冊的合作夥伴可建立已驗證簡訊代理程式，讓您使用 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 像素的直徑為圓形。請確保標誌以圓形呈現。

  • 代理人的品牌員工名稱與電子郵件地址 代表誰能驗證您與品牌的商業關係，以及您有權代表品牌

建立代理程式

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

  1. 開啟 Business Communications Developer Console，然後使用已驗證簡訊的 Google 帳戶登入。
  2. 按一下 [建立代理程式]。
  3. 如果系統提示您「代理程式類型」，請選擇 [已驗證簡訊]。
  4. 輸入「品牌名稱」和「代理程式名稱」的值。

  5. 在「代理程式標誌」中，上傳您的標誌或指定可公開存取的網址。

  6. 點選「下一步」。

  7. 輸入代理程式的傳送者 ID 及其相關聯的國家/地區，然後點選 [下一步]。

  8. 輸入品牌聯絡人、品牌網站本身和您自己的值。

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

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

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

更新服務專員資訊

代理程式資訊通過驗證後，您就可以更新寄件者 ID 及更新代理程式的公開金鑰。

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

刪除代理程式

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

如要刪除代理程式，請執行下列指令。將 BRAND_ID 和 AGENT_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)"
delete-agent.sh

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

刪除品牌

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

如要刪除品牌，請執行下列指令。將 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)"
delete-brand.sh

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

後續步驟

開始使用已驗證簡訊儲存郵件雜湊之前，

完成後，您就可以傳送已驗證訊息。