An agent is a conversational representation of a brand (and all the infrastructure that powers the representation) that users interact with on their devices.
As a registered partner you can create Verified SMS agents, which let you use the Verified SMS API and define the branding information displayed in conversations with users. When you store message hashes with Verified SMS, you call the API and associate the message with a particular agent.
For example, to send verified messages on behalf of the brand Growing Tree Bank, you create a Growing Tree Bank agent with Verified SMS. You use your partner credentials to authenticate API calls with Verified SMS and store message hashes as Growing Tree Bank, and the agent displays Growing Tree Bank's branding information in conversations with users.
If you manage multiple brands, create an agent for each brand with Verified SMS.
Verified SMS agents can have sender IDs in multiple countries, but agents' branding information, including agent name and description, isn't localized.
To have localized branding information for your agent, create an agent for each language you send messages in. Localize the agent display name and description, but specify the same non-localized brand name for each agent. If you have unique sender IDs per language, make sure to associate them with the correct localized agents.
By default, Verified SMS contacts a brand to perform branding verification each time you create an agent. If you anticipate creating multiple localized agents and would prefer Google to contact the brand once for bulk branding verification, contact us.
Create an agent
To create an agent, you need to gather and submit information about the brand and how you want the agent to appear to users.
Before you can create an agent, you need to gather the some information:
- Brand name
- Brand website
- Agent name, as you want it to appear in conversations with users (maximum 40 characters)
- Agent description
Agent logo (JPEG or PNG) as a file or a publicly available URL
In conversations, logos display as 224 px diameter circles. Make sure that your logo displays well as a circle.
Test your logo
Enter a URL for your logo to see how it would look to users.
- Name and email for an employee of the brand the agent represents who can verify your business relationship with the brand and your authority to represent the brand
Create the agent
Once you've gathered your information, it's time to create your agent.
- Open the Business Communications Developer Console and sign in with your Verified SMS Google account.
- Click Create agent.
- If you're prompted for Agent type, choose Verified SMS.
- Enter values for Brand name and Agent name.
For Agent logo, upload your logo or specify a publicly-accessible URL.
Enter the agent's sender IDs and their associated countries, then click Next.
Enter values for the brand contact, brand website, and yourself.
Click Finish setup.
Your agent appears in the agent list but is unavailable. After the brand approves your agent information, your agent becomes available.
Update agent information
To update other agent details, contact us. Identify the agent and the information that you want to update, including the new values. After you submit the new information, it can take up to three business days to update the agent information.
Delete an agent
When you delete an agent, you perform a DELETE request with the Business Communications API. Delete requests fail if you've attempted to verify the agent one or more times. To delete an agent that you've verified or attempted to verify, contact us.
To delete an agent, run the following command. Replace BRAND_ID
and AGENT_ID with the unique values from the agent's
curl -X DELETE "https://businesscommunications.googleapis.com/v1/brands/BRAND_ID/agents/AGENT_ID" \ -H "Content-Type: application/json" \ -H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)"
For formatting and value options, see
Delete a brand
When you delete a brand, you perform a DELETE request with the Business Communications API. Delete requests fail if you have one or more agents or locations associated with the brand, even if those agents belong to a different product.
To delete a brand, run the following command. Replace BRAND_ID with
the unique value from the brand's
curl -X DELETE "https://businesscommunications.googleapis.com/v1/brands/BRAND_ID" \ -H "Content-Type: application/json" \ -H "$(oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications)"
For formatting and value options, see
Before you begin storing message hashes with Verified SMS,
- create and update your agent's private/public key pair
- configure message hashing
- set up a test device
Once you've done that, you're ready to send a verified message.