Impostare la disponibilità dei messaggi

Prima che gli utenti possano avviare conversazioni con il tuo agente, devi impostare la disponibilità di messaggistica dell'agente in Business Messages.

Se un utente invia un messaggio al tuo agente durante l'orario di disponibilità, l'agente saluta l'utente con un messaggio di benvenuto e suggerimenti per iniziare la conversazione. Se la conversazione inizia al di fuori dell'orario disponibile, gli utenti visualizzano il messaggio offline dell'agente. Per saperne di più su questi messaggi, consulta la sezione Inizia la conversazione.

Disponibilità di bot e persone

Puoi specificare la disponibilità separata di bot e rappresentanti umani.

Se hai un'automazione che compone messaggi per il tuo agente, che si tratti di una risposta automatica che comunica agli utenti il loro posto in una coda, di un agente complesso di comprensione del linguaggio naturale che ha accesso dinamico ai dettagli dell'utente o di qualsiasi altra cosa, specifica la disponibilità della messaggistica del bot.

La disponibilità di un operatore è obbligatoria se vuoi lanciare un agente su punti di ingresso gestiti da Google, inclusi i punti di ingresso basati sulla posizione e i punti di ingresso non locali (ad eccezione di Google Ads). Per la disponibilità umana, specifica solo i giorni della settimana e le ore in cui hai agenti live disponibili a rispondere alle domande.

Se i rappresentanti bot sono disponibili 24 ore al giorno, ma i rappresentanti umani sono disponibili dalle 8:00 alle 20:00, puoi specificare questi orari in modo indipendente.

Inoltre, se specifichi la disponibilità sia del bot sia dell'operatore, puoi inviare suggerimenti per la richiesta di un operatore per invitare gli utenti a richiedere operatori se i rappresentanti del bot non riescono a soddisfare le loro esigenze.

Aggiornare la disponibilità della messaggistica

Per aggiornare la disponibilità della messaggistica, effettua una richiesta PATCH con l'API Business Communications per aggiornare i campi primaryAgentInteraction e additionalAgentInteractions di un agente.

Quando aggiorni questi campi, devi includere i valori per tutti i campi nell'oggetto SupportedAgentInteraction. Le richieste di aggiornamento sovrascrivono i contenuti di tutti i campi che modifichi, inclusi i campi secondari. Ad esempio, se fai una richiesta per aggiungere un'istanza a hours, devi includere anche tutte le istanze hours precedenti, altrimenti l'aggiornamento le sovrascrive.

Prerequisiti

Prima di aggiornare la disponibilità della messaggistica, devi disporre di quanto segue:

  • Percorso della chiave del service account del progetto GCP sulla macchina di sviluppo

  • L'agente name (ad esempio, "brands/12345/agents/67890")

    Se non conosci l'name dell'agente, consulta Elenco di tutti gli agenti per un brand.

  • Fusi orari, giorni della settimana e orari di disponibilità del bot

  • Fusi orari, giorni della settimana e orari di disponibilità degli operatori

Se non conosci i valori attuali di primaryAgentInteraction e additionalAgentInteractions, consulta Recuperare le informazioni dell'agente.

Inviare la richiesta di aggiornamento

Per aggiornare l'agente, esegui questo comando. Sostituisci le variabili con i valori che hai identificato in Prerequisiti.

Se hai a disposizione sia la messaggistica con bot che quella con persone, specifica la disponibilità dei bot in primaryAgentInteraction e la disponibilità delle persone in un'istanza di additionalAgentInteractions.

Bot e persone 

# 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"
              }
            ]
          }
        }
      }
    ]
  }
}'

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"
            }
          ]
        }
      }
    }
  }
}'

Solo persone 

# 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"
            }
          ]
        }
      }
    }
  }
}'

Per le opzioni di formattazione e valore, vedi brands.agents.patch e SupportedAgentInteraction.