Se usó la API de Cloud Translation para traducir esta página.

Regístrate con Business Messages

Cuando te registras como socio con Business Messages, puedes habilitar las conversaciones entre los usuarios y las marcas mediante la creación de agentes, es decir, entidades conversacionales que representan funciones empresariales, como la asistencia en el sitio web y la ubicación de la marca.

Cuando un usuario encuentra una marca que administras en la Búsqueda de Google o en Google Maps, los resultados de la búsqueda muestran la opción Chat. Cuando el usuario hace clic en Chat, puede enviar mensajes al agente de la marca. El agente te permite recibir y responder los mensajes del usuario.

Registrarse como socio

Si te registras como socio con Business Messages, creas agentes para las marcas y aprovechas las API que potencian a tu agente, puedes habilitar las experiencias de mensajería en los servicios de atención al cliente, las ventas y otras aplicaciones empresariales.

Abre Business Communications Developer Console.
En Business Messages, haga clic en Create partner account.

Ingrese valores para su información de socio:

Campo	Valor
Tu nombre	Su nombre completo
Nombre del socio	Nombre de tu organización
Sitio web del socio	Sitio web de tu organización
Región	La región en la que deseas alojar el servicio de Business Messages

Revisa y acepta las Condiciones del Servicio de Business Messages.
Haz clic en Crear.

Ahora estás registrado como socio de Business Messages y tienes acceso a las API de Business Messages y Business Communications. La API de Business Messages envía mensajes a los usuarios, mientras que la API de Business Communications administra los agentes.

Crea una cuenta de servicio

Para autenticar de manera segura las llamadas a la API de Business Messages y las API de Business Communications, necesitas una clave de cuenta de servicio y la herramienta de línea de comandos oauth2l.

En la página principal de Business Communications Developer Console, haz clic en Configuración de la cuenta de socio.
En el panel de navegación izquierdo, haz clic en Cuenta de servicio.
Haz clic en Crear clave y, luego, en Crear.

Tu navegador descarga la clave de la cuenta de servicio. Almacena la clave de tu cuenta de servicio en una ubicación privada y segura. No compartas tu clave públicamente. Necesitará esta clave más adelante para acceder a las API de Business Messaging y Business Communication.

Configura tu libro de visitas

Ahora que la API de Business Messages y Business Communications está habilitada, debes especificar tu URL de webhook para comenzar a recibir mensajes.

Abre la Configuración de la cuenta en la consola para desarrolladores de Business Communications.
Asegúrate de que esté seleccionada la cuenta de socio correcta.
En URL de webhook de Business Messages, haz clic en Configurar.
En URL de extremo de webhook, ingresa la URL de tu webhook. Comienza con “https://”.
Anota tu valor de clientToken. Lo necesitas para verificar que los mensajes que recibes provienen de Google.
Configura tu webhook para aceptar una solicitud POST con el parámetro clientToken especificado y envía una respuesta 200 OK con el valor de texto sin formato del parámetro secret como el cuerpo de la respuesta.

Por ejemplo, si tu webhook recibe una solicitud POST con el siguiente contenido del cuerpo:
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
el webhook debería confirmar el valor de clientToken y, si clientToken es correcto, mostrar una respuesta de 200 OK con 0123456789 como el cuerpo de la respuesta.
En la consola, haz clic en Verificar.

Cuando Business Messages verifica tu webhook, se cierra el diálogo.

Consulta Ejemplo: Actualiza la URL de webhook para ver cómo configurar tu webhook con las API de Business Communication.

Obtener información de socios

Para obtener la información actual de tu socio, puedes consultar la API de Business Communications con tu ID de socio.

Ejecuta el siguiente comando. Reemplaza PARTNER_ID por tu ID de socio.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

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

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-partner.sh

Actualizar la información del socio

Para actualizar la información de tu socio, puedes usar la página Configuración de la cuenta en la consola para programadores de comunicaciones empresariales o ejecutar los siguientes comandos.

Reemplaza PARTNER_ID por tu ID de socio(el ID de socio se puede encontrar en Business Communications Console) y reemplaza UPDATED_FIELDS por los nombres de campo que actualizas.


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'update-partner.sh

Para ver las opciones de formato y valor, consulta partners.patch.

Ejemplo: Actualiza el nombre visible

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

Ejemplo: Actualiza la URL de webhook

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

Próximos pasos

Ahora que eres un socio registrado y habilitaste las API, puedes comenzar a desarrollar con Business Messages. Para comenzar con rapidez, consulta Crea tu primer agente.

De lo contrario, aprende a crear agentes a fin de representar tus marcas en las conversaciones y configurar el webhook para que reciba mensajes de los usuarios.