Définir la disponibilité des messages

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

Si un utilisateur envoie un message à votre agent pendant les heures disponibles, celui-ci accueille l'utilisateur avec un message de bienvenue et des moyens d'engager la conversation. Si la conversation commence en dehors des heures disponibles, le message hors connexion de l'agent s'affiche. Pour en savoir plus sur ces messages, consultez la section Démarrer la conversation.

Disponibilité des bots et humains

Vous pouvez spécifier une disponibilité représentative distincte pour les bots.

Si vous disposez d'une sorte d'automatisation pour rédiger des messages pour votre agent, qu'il s'agisse d'une réponse automatique indiquant aux utilisateurs leur place dans une file d'attente, d'un agent de compréhension du langage naturel complexe ayant un accès dynamique aux détails de l'utilisateur ou d'un élément intermédiaire, spécifiez la disponibilité de la messagerie des bots.

La disponibilité humaine est essentielle si vous souhaitez lancer un agent sur des points d'entrée gérés par Google, y compris des points d'entrée basés sur la localisation et des points d'entrée non locaux (sauf pour Google Ads). Pour les disponibilités manuelles, indiquez uniquement les jours de la semaine et les heures où vous pouvez contacter des agents en direct pour répondre aux questions.

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

En outre, si vous spécifiez à la fois la disponibilité des bots et celle des utilisateurs humains, vous pouvez envoyer des suggestions de demandes d'agents en direct pour inviter les utilisateurs à demander des agents en direct si les représentants des bots ne peuvent pas répondre à leurs besoins.

Mettre à jour la disponibilité des messages

Pour mettre à jour la disponibilité des messages, envoyez une requête PATCH à l'API Business Communications afin de mettre à jour les champs primaryAgentInteraction et additionalAgentInteractions de l'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 effectuez une requête pour ajouter une instance à hours, vous devez également inclure toutes les instances hours précédentes. Sinon, elles seront écrasées.

Conditions préalables

Avant de mettre à jour la disponibilité des messages, vous devez disposer des éléments suivants:

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

  • Agent name (par exemple, "brands/12345/agents/67890")

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

  • Fuseau horaire de disponibilité du bot, jours de la semaine et heures

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

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

Envoyer la demande de mise à jour

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

Si vous disposez à la fois d'une disponibilité du bot et de la messagerie humaine, spécifiez la disponibilité du bot dans primaryAgentInteraction et la disponibilité humaine dans une instance de additionalAgentInteractions.

Bot et humain 


# 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

Bot 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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-bot.sh

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

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