Définir la disponibilité des messages

Avant que les utilisateurs puissent commencer à discuter avec votre agent, vous devez définir sa disponibilité pour la messagerie dans Business Messages.

Si un utilisateur envoie un message à votre agent pendant les heures de disponibilité, celui-ci l'accueille avec un message de bienvenue et des amorces de conversation. Si la conversation commence en dehors des heures de disponibilité, les utilisateurs voient le message d'état hors connexion de l'agent. Pour en savoir plus sur ces messages, consultez Commencer la conversation.

Disponibilité des bots et des humains

Vous pouvez spécifier la disponibilité des bots et des représentants humains séparément.

Si vous utilisez une forme d'automatisation pour rédiger des messages pour votre agent (qu'il s'agisse d'un répondeur automatique indiquant aux utilisateurs leur place dans une file d'attente, d'un agent complexe de compréhension du langage naturel ayant un accès dynamique aux informations de l'utilisateur ou de tout autre élément), spécifiez la disponibilité de la messagerie du bot.

La disponibilité humaine est obligatoire si vous souhaitez lancer un agent sur des points d'entrée gérés par Google, y compris les points d'entrée basés sur la zone géographique et les points d'entrée non locaux (à l'exception de Google Ads). Pour la disponibilité humaine, spécifiez uniquement les jours de la semaine et les heures pendant lesquels des agents sont disponibles pour répondre aux questions.

Si les représentants de bot sont disponibles 24h/24, mais que les représentants humains sont disponibles de 8h à 20h, vous pouvez spécifier ces informations indépendamment.

De plus, si vous spécifiez la disponibilité des bots et des humains, vous pouvez envoyer des suggestions de demande d'agent en direct pour inviter les utilisateurs à demander des agents en direct si les représentants de bot ne peuvent pas répondre à leurs besoins.

Mettre à jour la disponibilité de la messagerie

Pour mettre à jour la disponibilité de la messagerie, envoyez une requête PATCH avec l'API Business Communications afin de mettre à jour les champs primaryAgentInteraction et additionalAgentInteractions d'un agent.

Lorsque vous mettez à jour ces champs, vous devez inclure des valeurs pour tous les champs de l'objet SupportedAgentInteraction. Les requêtes de mise à jour écrasent le contenu de tous les champs que vous modifiez, y compris les champs enfants. Par exemple, si vous envoyez une requête pour ajouter une instance à hours, vous devez également inclure toutes les instances hours précédentes. Sinon, votre mise à jour les écrasera.

Prérequis

Avant de mettre à jour la disponibilité de la messagerie, vous avez besoin des éléments suivants :

  • Chemin d'accès à la clé du compte de service de votre projet GCP sur votre ordinateur de développement

  • name de l'agent (par exemple, "brands/12345/agents/67890")

    Si vous ne connaissez pas le name de l'agent, consultez Répertorier tous les agents d'une marque.

  • Fuseaux horaires, jours de la semaine et heures de disponibilité des bots

  • Fuseaux horaires, jours de la semaine et heures de disponibilité des humains

Si vous ne connaissez pas les valeurs actuelles de primaryAgentInteraction et additionalAgentInteractions, consultez Obtenir des informations sur l'agent.

Envoyer la requête de mise à jour

Pour mettre à jour l'agent, exécutez la commande suivante. Remplacez les variables par les valeurs que vous avez identifiées dans Prérequis.

Si vous disposez de la disponibilité de la messagerie des bots et des humains, spécifiez la disponibilité des bots dans primaryAgentInteraction et la disponibilité humaine dans une instance de additionalAgentInteractions.

Bots et humains 

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

Bots uniquement 

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

Humains uniquement 

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

Pour connaître les options de mise en forme et de valeur, consultez brands.agents.patch et SupportedAgentInteraction.