Integrar locais pelo Perfil da Empresa

O Perfil da Empresa no Google é uma ferramenta sem custo financeiro e fácil de usar para empresas e organizações gerenciarem a presença on-line no Google, incluindo na Pesquisa Google e no Maps.

A API Google Business Profile oferece uma interface para gerenciar informações do local da empresa no Google. Uma empresa pode conceder acesso por meio do consentimento do OAuth a outra empresa para que possa gerenciar o perfil em nome dela.

As empresas gerenciadas no Perfil da empresa já foram verificadas pelo processo de verificação. É possível estender o fluxo de consentimento do OAuth do Perfil da Empresa para integrar essas empresas ao Business Messages e fazer a verificação automática delas para lançamento no Business Messages.

Esse é um método mais escalonável e rápido para lançar o Business Messages e é o fluxo recomendado para ativar mensagens em um local do Perfil da Empresa.

Pré-requisitos

Você precisa ser um parceiro do Perfil da empresa e ter acesso às APIs do Perfil da empresa. Se não estiver, siga os pré-requisitos do Perfil da Empresa para solicitar acesso.

Depois de receber acesso à API Google Business Profile, siga as orientações da configuração básica e da configuração do OAuth antes de continuar.

Ativar o Business Messages para um local verificado do Perfil da Empresa

O diagrama a seguir mostra como o serviço da Web pode aproveitar a verificação de local do Perfil da Empresa de um agente do Business Messages. Veja abaixo instruções detalhadas.

Diagrama de fluxo para verificar agentes automaticamente usando a verificação do Perfil da Empresa

  1. No fluxo de consentimento atual do OAuth em que o proprietário de uma conta do Perfil da Empresa concede acesso para chamar as APIs do Perfil da Empresa no Google, atualize os escopos da API a serem incluídos

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

    Os dois escopos são necessários para verificar automaticamente o agente e os locais da empresa.

  2. Crie um agente com um displayName que corresponda ao nome de pelo menos uma das fichas do Perfil da empresa no Google pertencentes às credenciais do OAuth recebidas na etapa anterior. Pesquise locais com a API Google Business Profile para encontrar os nomes das empresas.

    Para correspondência de nome,

    • A diferença de maiúsculas e minúsculas é insensível.
    • O nome completo do agente precisa corresponder exatamente às primeiras palavras no nome do local do Perfil da Empresa. Por exemplo, um agente chamado "GBP Padaria" corresponde a "Gbp Padariay Mountain View", "Gbp Padariay" e "gbp paste Sunvale", mas não corresponde a "Bakery San Francisco".

  3. Para cada local no Perfil da empresa, crie um local com o mesmo placeId. O placeId de um local do Perfil da Empresa está no objeto LocationKey quando um local é recuperado pela API Google Business Profile.

  4. Com o agente que você criou e o token de OAuth recebido, solicite a verificação do agente.

    A solicitação de verificação requer dados de contato da marca. No entanto, o processo de verificação não enviará um e-mail para a marca se o nome do agente corresponder ao nome do Perfil da Empresa e se você tiver recebido o token OAuth com os escopos corretos.

    Se você fez isso corretamente, a saída da solicitação de verificação retornará imediatamente um verificationState de VERIFICATION_STATE_VERIFIED. Se verificationState retornar um valor diferente, é provável que você não tenha usado o token de OAuth correto ao fazer a solicitação ou que o agente não tenha sido correspondido a um local do Perfil da Empresa.

  5. Usando o mesmo token OAuth, solicite a verificação do local de todos os locais da empresa no Perfil da empresa.

    Assim como na verificação do agente, se você tiver feito isso corretamente, a saída da solicitação de verificação retornará imediatamente um verificationState de VERIFICATION_STATE_VERIFIED. Se verificationState retornar um valor diferente, é provável que você não tenha usado o token OAuth correto ao fazer a solicitação, ou o local do Perfil da empresa não for uma empresa reivindicada e verificada.

  6. Inicie o agente com o ponto de entrada LOCATION.

  7. Ative as mensagens para locais específicos iniciando os locais que você quer que estejam disponíveis por meio da Pesquisa Google e do Maps. Depois que o processo de lançamento começa, as mensagens para cada local iniciado são disponibilizadas para os usuários em algumas horas.

Depois de seguir essas etapas, todas as mensagens dos consumidores serão postadas no webhook registrado do Business Messages, e você precisará enviar respostas aos consumidores com a API Business Messages.