Definir a disponibilidade das mensagens

Para que os usuários possam iniciar conversas com seu agente, você precisa definir a disponibilidade dele no Business Messages.

Se um usuário enviar uma mensagem para seu agente durante o horário disponível, seu agente o cumprimentará com uma mensagem de boas-vindas e um inicializador de conversas. Se a conversa começar fora do horário disponível, os usuários verão a mensagem off-line do agente. Consulte Iniciar a conversa para mais informações sobre essas mensagens.

Disponibilidade de bots e pessoas

É possível especificar a disponibilidade de representativos de bots e humanos.

Se você tiver algum tipo de automação que componha mensagens para seu agente, seja a resposta automática, informando aos usuários o lugar deles em uma fila, um agente de processamento de linguagem natural complexo que tenha acesso dinâmico aos detalhes do usuário ou qualquer outro meio, especifique a disponibilidade das mensagens do bot.

A disponibilidade humana é obrigatória se você quer lançar um agente em pontos de entrada gerenciados pelo Google, incluindo pontos de entrada com base no local e pontos de entrada não locais, exceto o Google Ads. Para disponibilidade humana, especifique somente os dias da semana e os horários em que você tem agentes ativos disponíveis para responder às perguntas.

Se os representantes de bot estiverem disponíveis 24 horas por dia, mas representantes humanos estiverem disponíveis das 8h às 20h, será possível especificá-los de maneira independente.

Além disso, se você especificar a disponibilidade humana e de bots, vai poder enviar sugestões de solicitações de agentes em tempo real para solicitar que os usuários os solicitem se os representantes de bot não atenderem às necessidades deles.

Atualizar disponibilidade de mensagens

Para atualizar a disponibilidade de mensagens, faça uma solicitação PATCH com a API Business Communications para atualizar os campos primaryAgentInteraction e additionalAgentInteractions de um agente.

Ao atualizar esses campos, é preciso incluir valores para todos os campos no objeto SupportedAgentInteraction. As solicitações de atualização substituem o conteúdo de todos os campos editados, incluindo os campos filhos. Por exemplo, se você fizer uma solicitação para adicionar uma instância ao hours, também precisará incluir todas as instâncias hours anteriores. Caso contrário, a atualização as substituirá.

Pré-requisitos

Antes de atualizar a disponibilidade de mensagens, você precisa dos seguintes itens:

  • Caminho para a chave da conta de serviço do seu projeto do GCP na máquina de desenvolvimento

  • O agente name (por exemplo, "brands/12345/agents/67890")

    Se você não souber o name do agente, consulte Listar todos os agentes de uma marca.

  • Fusos horários de disponibilidade de bots, dias da semana e horas

  • Fusos horários de disponibilidade humana, dias da semana e horários

Se você não souber os valores atuais de primaryAgentInteraction e additionalAgentInteractions, consulte Receber informações do agente.

Enviar o pedido de atualização

Para atualizar o agente, execute o comando a seguir. Substitua as variáveis pelos valores identificados em Pré-requisitos.

Se você tiver disponibilidade de bots e mensagens humanas, especifique a disponibilidade de bots em primaryAgentInteraction e a disponibilidade humana em uma instância de additionalAgentInteractions.

Bot e humano 


# This code updates the agent interaction of a bot and human representatives.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction,businessMessagesAgent.additionalAgentInteractions" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    },
    "additionalAgentInteractions": [
      {
        "interactionType": "HUMAN",
        "humanRepresentative": {
          "humanMessagingAvailability": {
            "hours": [
              {
                "startTime": {
                  "hours": 8,
                  "minutes": 0
                },
                "endTime": {
                  "hours": 20,
                  "minutes": 0
                },
                "timeZone": "America/Los_Angeles",
                "startDay": "MONDAY",
                "endDay": "SUNDAY"
              }
            ]
          }
        }
      }
    ]
  }
}'
update-agent-bm-agentInteractions-bot-and-human.sh

Somente bot 


# This code updates the primary agent interaction of a bot representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-bot.sh

Somente humanos 


# This code updates the primary agent interaction of a human representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "HUMAN",
      "humanRepresentative": {
        "humanMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-human.sh

Para opções de formatação e valor, consulte brands.agents.patch e SupportedAgentInteraction.