Cómo establecer la disponibilidad de mensajes

Antes de que los usuarios puedan iniciar conversaciones con tu agente, debes configurar tu disponibilidad de la mensajería del agente en Business Messages.

Si un usuario envía un mensaje a tu agente durante el horario disponible, el agente lo saluda. con un mensaje de bienvenida y temas de conversación. Si la conversación comienza fuera del horario disponible, los usuarios ven el mensaje sin conexión del agente. Consulta Comenzar el conversación para obtener más información sobre estos mensajes.

Bot y disponibilidad humana

Puedes especificar un bot y una persona representante disponibilidad.

Si tienes algún tipo de automatización que redacta mensajes para tus es decir, si la automatización es una respuesta automática que les dice a los usuarios su lugar en una fila, un agente complejo de comprensión del lenguaje natural que tiene acceso dinámico a los detalles del usuario o cualquier otra opción, especifica la disponibilidad de mensajes de bots.

La disponibilidad humana es obligatoria si quieres lanzar un agente en un entorno administrado puntos de entrada, incluidos los puntos de entrada basados en la ubicación y puntos de entrada no locales (excepto Google Ads). En cuanto a la disponibilidad humana, solo especifica los días de la semana y las horas en que los agentes humanos están disponibles para responder preguntas.

Si los representantes de bots están disponibles las 24 horas del día pero hay representantes humanos disponibles de 8 a.m. a 8 p.m., puedes especificarlos de forma independiente.

Además, si especificas la disponibilidad de bots y personas, Puede enviar una solicitud de agente en vivo sugerencias para pedirles a los usuarios que soliciten agentes humanos si los representantes de los bots no pueden entregar sus necesidades.

Actualiza la disponibilidad de los mensajes

Para actualizar la disponibilidad de los mensajes, debes realizar una solicitud PATCH a la empresa. Communications para actualizar el primaryAgentInteraction de un agente y additionalAgentInteractions campos.

Cuando actualices estos campos, debes incluir valores para todos los campos del SupportAgentInteraction. Las solicitudes de actualización reemplazan el contenido de todas campos que edites, incluidos los campos secundarios. Por ejemplo, si realizas una solicitud Para agregar una instancia a hours, debes incluir todos los hours anteriores las instancias también; de lo contrario, la actualización las reemplazará.

Requisitos previos

Antes de actualizar la disponibilidad de los mensajes, necesitas los siguientes elementos:

  • Ruta de acceso a la clave de la cuenta de servicio del proyecto de GCP en la máquina de desarrollo

  • El agente name (por ejemplo, "brands/12345/agents/67890")

    Si no conoces la name del agente, consulta Enumerar todos los agentes de un brand [marca].

  • Zonas horarias, días de la semana y horarios de disponibilidad de los bots

  • Zonas horarias, días de la semana y horarios de disponibilidad humana

Si no conoces el primaryAgentInteraction actual y Los valores de additionalAgentInteractions, consulta Obtener agentes información.

Cómo enviar la solicitud de actualización

Para actualizar el agente, ejecuta el siguiente comando. Reemplaza variables por valores identificaste en Requisitos previos.

Si tienes disponibilidad de mensajería humana y de bots, especifica la disponibilidad de estos. en primaryAgentInteraction y la disponibilidad humana en una instancia de additionalAgentInteractions

Bot y humanos 

# 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

Solo 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

Solo para personas 

# 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 ver las opciones de formato y valor, consulta brands.agents.patch y SupportedAgentInteraction