Definir a disponibilidade de mensagens

Antes que os usuários possam iniciar conversas com seu agente, você precisa definir o a disponibilidade de mensagens do agente no Business Messages.

O agente vai cumprimentá-lo se um usuário enviar uma mensagem durante o horário disponível. com uma mensagem de boas-vindas e perguntas para puxar conversa. Se a conversa começar fora do horário disponível, a mensagem off-line do agente vai aparecer para os usuários. Consulte Começar as conversa para mais informações sobre essas mensagens.

Disponibilidade de bots e usuários

É possível especificar opções separadas de bot e humano de vendas disponibilidade.

Se você usa algum tipo de automação para escrever mensagens e se a automação é uma resposta automática que diz aos usuários qual será o lugar em um um agente de processamento de linguagem natural complexo que tem acesso dinâmico a detalhes do usuário ou qualquer outra opção, especifique a disponibilidade das mensagens do bot.

A disponibilidade humana é essencial para lançar um agente em uma plataforma pontos de entrada, incluindo pontos de entrada baseados em localização e pontos de entrada não locais (exceto para o Google Ads). Para disponibilidade humana, especifique somente os dias da semana e os horários em que há atendentes disponíveis para responder a perguntas.

Se os representantes do bot estiverem disponíveis 24 horas por dia mas os representantes humanos estão disponíveis das 8h às 20h, você pode especificar de forma independente.

Além disso, se você especificar a disponibilidade de bots e humanos, pode enviar solicitação de agente em tempo real sugestões solicitar aos usuários que solicitem atendentes se os representantes do bot não puderem atender às necessidades da empresa.

Atualizar disponibilidade de mensagens

Para atualizar a disponibilidade de mensagens, faça uma solicitação PATCH com a conta de API Communications para atualizar primaryAgentInteraction e additionalAgentInteractions.

Quando você atualiza esses campos, deve incluir valores para todos os campos na supportedAgentInteraction. As solicitações de atualização substituem o conteúdo de todas os campos editados, incluindo os filhos. Por exemplo, se você fizer uma solicitação para adicionar uma instância a hours, é necessário incluir todos os hours anteriores as instâncias de VM, caso contrário, elas serão substituídas pela atualização.

Pré-requisitos

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

  • Caminho para a chave da conta de serviço do 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 um marca.

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

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

Se você não souber o primaryAgentInteraction atual e additionalAgentInteractions, consulte Receber agente mais recentes.

Enviar a solicitação de atualização

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

Se você tiver disponibilidade de bot e mensagens humanas, especifique a disponibilidade do bot 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 para 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