Incorpore ubicaciones desde el Perfil de Negocio

El Perfil de Negocio es una herramienta gratuita y fácil de usar para que las empresas y organizaciones administren su presencia en línea en Google, incluidos la Búsqueda y Maps.

La API del Perfil de Negocio de Google proporciona una interfaz para administrar la información de la ubicación de la empresa en Google. Una empresa puede otorgar acceso a otra empresa a través del consentimiento de OAuth para que administre su perfil en su nombre.

Las empresas administradas en el Perfil de Negocio ya se verificaron a través del proceso de verificación del Perfil de Negocio. Puedes extender el flujo de consentimiento de OAuth del Perfil de Negocio para incorporar estas empresas a Business Messages y verificarlas de forma automática para el lanzamiento en Business Messages.

Este es un método más escalable y rápido para iniciar Business Messages y es el flujo recomendado si deseas habilitar la mensajería en una ubicación de Perfil de Negocio.

Requisitos previos

Debes ser un socio del Perfil de Negocio existente con acceso a las API del Perfil de Negocio de Google. Si no lo eres, sigue los requisitos previos del Perfil de Negocio para solicitar acceso.

Una vez que se te otorgue acceso a la API del Perfil de Negocio de Google, sigue sus guías de configuración básica y configuración de OAuth antes de continuar.

Habilita Business Messages para la ubicación de un Perfil de Negocio verificado

En el siguiente diagrama, se muestra cómo tu servicio web puede aprovechar la verificación de ubicación del Perfil de Negocio de una marca para un agente de Business Messages. Consulta las instrucciones detalladas a continuación.

1. En el flujo de consentimiento existente de OAuth en el que un propietario de cuenta de Perfil de Negocio te otorga acceso para llamar a las API de Perfil de Negocio de Google en su nombre, actualiza los permisos de la API a fin de incluir

   • https://www.googleapis.com/auth/business.manage
   • https://www.googleapis.com/auth/businesscommunications

   Ambos alcances son necesarios para verificar de forma correcta el agente y las ubicaciones de la empresa.

2. Crea un agente con un displayName que coincida con el nombre de al menos una de las fichas del Perfil de Negocio de Google que pertenecen a las credenciales de OAuth que obtuviste en el paso anterior. Busca las ubicaciones con la API del Perfil de Negocio de Google para encontrar los nombres de las empresas.

   Para la coincidencia de nombres,

   • El uso de mayúsculas y minúsculas es sensible.
   • El nombre completo del agente debe coincidir exactamente con la primera palabra o las palabras del nombre de la ubicación del Perfil de Negocio. Por ejemplo, un agente llamado “GBP Bakery” coincide con “Gbp Bakery Mountain View”, “Gbp Bakery” y “gbp Bakery solevale”, pero no coincide con “Bakery San Francisco”.

3. Para cada ubicación en el Perfil de Negocio, crea una ubicación con el mismo placeId. El placeId de la ubicación de un Perfil de Negocio se encuentra dentro del objeto LocationKey cuando se recupera una ubicación desde la API del Perfil de Negocio de Google.

4. Con el agente que creaste y el token de OAuth obtenido, solicita la verificación del agente.

   Nota: Debes usar el token de OAuth de alcance doble obtenido, no la clave de la cuenta de servicio de tu proyecto.

   La solicitud de verificación requiere información de contacto de la marca. Sin embargo, el proceso de verificación no enviará un correo electrónico a la marca si el nombre del agente coincide con el nombre del Perfil de Negocio y si obtuviste el token de OAuth con los permisos correctos.

   Si lo hiciste de forma correcta, el resultado de la solicitud de verificación debería mostrar de inmediato un verificationState de VERIFICATION_STATE_VERIFIED. Si verificationState muestra un valor diferente, es probable que no hayas usado el token de OAuth correcto cuando se realizó la solicitud o que el agente no pudo coincidir con una ubicación del Perfil de Negocio.

5. Con el mismo token de OAuth, solicita la verificación de la ubicación para todas las ubicaciones que pertenecen a la empresa en el Perfil de Negocio.

   Al igual que con la verificación del agente, si lo hiciste de forma correcta, el resultado de la solicitud de verificación debería mostrar de inmediato un verificationState de VERIFICATION_STATE_VERIFIED. Si verificationState muestra un valor diferente, es probable que no hayas usado el token de OAuth correcto cuando se realizó la solicitud o que la ubicación del Perfil de Negocio no sea una empresa reclamada ni verificada.

6. Inicia el agente con el punto de entrada LOCATION.

7. Habilita los mensajes para ubicaciones específicas. Para ello, lanza las ubicaciones que deseas que estén disponibles mediante la Búsqueda y Maps. Una vez que comienza el proceso de lanzamiento, los mensajes para cada ubicación de lanzamiento están disponibles para los usuarios en unas horas.

Una vez que sigas estos pasos, todos los mensajes para consumidores se publican en tu webhook de Business Messages registrado y debes enviar las respuestas a los consumidores con la API de Business Messages.