Regístrate en Business Messages

Cuando te registras como socio en Business Messages, puedes habilitar conversaciones entre usuarios y marcas creando agentes, entidades que representan funciones comerciales, como la asistencia de sitios web y los atributos ubicaciones.

Agente: es una representación conversacional de una marca, administrada por un socio. Incluye cualquier con la que interactúan los usuarios y cualquier código o infraestructura que se necesite la interacción.

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

Regístrate como socio

Registrarse como socio en Business Messages, crear agentes para las marcas y aprovechar las APIs que potencian tu agente, puedes habilitar la mensajería para la atención al cliente, las ventas y otras aplicaciones empresariales.

1. Abre la consola para desarrolladores de Business Communications.
2. En Business Messages, haz clic en Crear cuenta de socio.

3. Ingresa los valores para la información de tu 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 quieres alojar el servicio de Business Messages

Nota: Para lanzar un agente de producción con Business Messages, debes registrarte con un correo electrónico corporativo, no con uno personal.

1. Revisa y acepta las Condiciones del Servicio de Business Messages

2. Haz clic en Crear.

Te registraste como socio de Business Messages y tienes acceso a las APIs 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 forma segura las llamadas a las APIs de Business Messages y Business Communications, necesitas una clave de cuenta de servicio y la oauth2l.

1. En la página principal de la consola para desarrolladores de Business Communications, haz clic en Partner account settings.
2. En el panel de navegación de la izquierda, haz clic Cuenta de servicio.

3. 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. Lo que no debes hacer comparte tu clave públicamente. Necesitarás esta clave más adelante para acceder a las APIs de Business Message y Business Communication.

Nota: Si eres socio de Business Messages con tu propia cuenta de GCP, puedes acceder a las claves de tu cuenta de servicio en la consola de Google Cloud.

Configurar tu libro

Ahora que habilitaste la API de Business Messages y Business Communications, puedes debes especificar tu URL de webhook para iniciar recibir mensajes.

1. Abre la Configuración de la cuenta en Business Communications Developer Console.
2. Asegúrate de que se haya seleccionado la cuenta de socio correcta.
3. En URL de webhook de Business Messages, haz clic en Configurar.
4. En URL de extremo de webhook, ingresa la URL de tu webhook. Comienza con “https://”.
5. Anota tu valor de clientToken. Lo necesitas para verificar que los mensajes reciben provienen de Google

6. Configura tu webhook para que acepte una solicitud POST con el valor especificado El parámetro clientToken y envía una respuesta 200 OK con el texto sin formato. el valor del parámetro secret como el cuerpo de la respuesta.

   Por ejemplo, si tu webhook recibe una solicitud POST con lo siguiente: contenido del cuerpo

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"0123456789"
   }
   

   tu webhook debería confirmar el valor de clientToken y, si clientToken es correcto, muestra una respuesta 200 OK con 0123456789 como el cuerpo de la respuesta.

7. En la consola, haz clic en Verificar.

   Cuando Business Messages verifique tu webhook, se cerrará el diálogo.

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

Obtén información del socio

Para obtener la información de tu socio actual, puedes consultar el 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

Actualiza la información de los socios

Para actualizar tu información de socio, puedes usar la página Configuración de la cuenta de Business Communications Developer Console o ejecutar los siguientes comandos.

Reemplazar PARTNER_ID por tu ID de socio(puedes encontrarlo en la Consola para desarrolladores de Business Communications) y reemplaza UPDATED_FIELDS por los nombres de los campos que actualices

# 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 es un socio registrado y habilitó las APIs, puede comenzar con Business Messages. Para comenzar rápidamente, consulta Crea tu primer agente.

De lo contrario, aprende a crear agentes para representar a tus marcas en conversaciones y configurar tu webhook para recibir mensajes de los usuarios.