Imposta la disponibilità della messaggistica

Prima che gli utenti possano iniziare le conversazioni con l'agente, è necessario impostare la disponibilità dei messaggi dell'agente in Business Messages.

Se un utente invia un messaggio all'agente durante l'orario disponibile, lo saluta con un messaggio di benvenuto e spunti di conversazione. Se la conversazione inizia al di fuori dell'orario disponibile, gli utenti visualizzano il messaggio offline dell'agente. Per ulteriori informazioni su questi messaggi, consulta Inizia la conversazione.

Disponibilità di bot e persone

Puoi specificare una disponibilità separata per bot e operatore rappresentativo umano.

Se hai un qualsiasi tipo di automazione che compone i messaggi per il tuo agente, che si tratti di un risponditore automatico che indica agli utenti la loro posizione in una coda, un agente complesso per la comprensione del linguaggio naturale con accesso dinamico ai dettagli degli utenti o qualsiasi altro elemento, specifica la disponibilità dei messaggi del bot.

La disponibilità da parte di persone fisiche è obbligatoria se vuoi lanciare un agente su punti di contatto gestiti da Google, inclusi punti di contatto basati sulla località e punti di ingresso non locali (tranne Google Ads). Per la disponibilità fisica, specifica solo i giorni della settimana e gli orari in cui hai a disposizione gli agenti per rispondere alle domande.

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

Inoltre, se specifichi sia la disponibilità di bot sia la disponibilità di persone, puoi inviare suggerimenti di richiesta di agenti dal vivo per chiedere agli utenti di richiedere agenti dal vivo se i rappresentanti dei bot non possono soddisfare le loro esigenze.

Aggiorna la disponibilità dei messaggi

Per aggiornare la disponibilità dei messaggi, invia una richiesta PATCH all'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 SupportedAgentInterazioni. Le richieste di aggiornamento sovrascrivono il contenuto di tutti i campi modificati, inclusi eventuali campi secondari. Ad esempio, se effettui una richiesta per aggiungere un'istanza a hours, devi includere anche tutte le istanze hours precedenti, altrimenti il tuo aggiornamento le sovrascrive.

Prerequisiti

Prima di aggiornare la disponibilità dei messaggi, devi disporre dei seguenti elementi:

  • Percorso della chiave dell'account di servizio del progetto GCP sulla macchina di sviluppo

  • L'agente name (ad esempio, "brand/12345/agenti/67890")

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

  • Fusi orari, giorni della settimana e orari dei bot

  • Fusi orari, disponibilità della settimana e orari

Se non conosci gli attuali valori primaryAgentInteraction e additionalAgentInteractions, consulta la sezione Ottenere informazioni sugli agenti.

Invia la richiesta di aggiornamento

Per aggiornare l'agente, esegui il comando seguente. Sostituisci le variabili con i valori identificati in Prerequisiti.

Se hai sia la disponibilità di bot che di messaggistica umana, specifica la disponibilità di bot in primaryAgentInteraction e la disponibilità di persone fisiche in un'istanza di additionalAgentInteractions.

Bot e umano 


# 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 per 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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-human.sh

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