Impostare la disponibilità dei messaggi

Prima che gli utenti possano avviare conversazioni con l'agente, devi impostare la disponibilità dei messaggi dell'agente in Business Messages.

Se un utente invia un messaggio all'agente durante gli orari disponibili, l'agente lo saluta con un messaggio di benvenuto e spunti di conversazione. Se la conversazione inizia al di fuori degli orari disponibili, gli utenti vedono il messaggio offline dell'agente. Vedi Inizia il conversazione per ulteriori informazioni su questi messaggi.

Disponibilità di bot e esseri umani

Puoi specificare bot e essere umani separati rappresentativo la disponibilità del servizio.

Se è presente un'automazione che compone i messaggi per il tuo di un agente, se l'automazione è una risposta automatica che indica agli utenti la loro posizione in una un agente complesso per la comprensione del linguaggio naturale con accesso dinamico dettagli dell'utente o altro: specifica la disponibilità della messaggistica dei bot.

La disponibilità umana è indispensabile se vuoi lanciare un agente su una piattaforma quali entry point, tra cui gli entry point basati sulla posizione e entry point non locali (ad eccezione di Google Ads). Per la disponibilità da parte di persone fisiche, specifica solo i giorni della settimana e gli orari in cui gli operatori sono disponibili per rispondere alle domande.

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

Inoltre, se specifichi la disponibilità sia di bot che di persone fisiche, può inviare una richiesta di operatore suggerimenti per richiedere agli utenti di richiedere agenti se i rappresentanti del bot non sono in grado di rispondere le loro esigenze.

Aggiornare la disponibilità dei messaggi

Per aggiornare la disponibilità dei messaggi, effettua una richiesta PATCH con l'attività API Communications per aggiornare primaryAgentInteraction e additionalAgentInteractions campi.

Quando aggiorni questi campi, devi includere i valori per tutti i campi della Oggetto SupportAgentInteraction. Le richieste di aggiornamento sovrascrivono i contenuti di tutti campi modificati, inclusi eventuali campi secondari. Ad esempio, se effettui una richiesta per aggiungere un'istanza a hours, devi includere tutti i hours precedenti delle istanze VM, altrimenti verranno sovrascritte dall'aggiornamento.

Prerequisiti

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

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

  • L'agente name (ad es. "brands/12345/agents/67890")

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

  • Fusi orari, giorni della settimana e orari della disponibilità dei bot

  • Fusi orari, giorni della settimana e orari relativi alla disponibilità umana

Se non conosci gli attuali primaryAgentInteraction e Valori di additionalAgentInteractions; consulta Recuperare l'agente informazioni.

Invia la richiesta di aggiornamento

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

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

Bot e essere 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

Essenziale 

# 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.