REST Resource: phones.agentMessages

Ressource : AgentMessage

Message envoyé par l'agent à un utilisateur.

Représentation JSON
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },
  "messageTrafficType": enum (MessageTrafficType),
  "richMessageClassification": {
    object (RichMessageClassification)
  },
  "totalPayloadSizeBytes": string,
  "carrier": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expireTime": string,
  "ttl": string
  // End of mutually exclusive fields.
}
Champs
name

string

Ce champ est défini par la plate-forme RCS for Business. Ne l'incluez pas lorsque vous créez un message d'agent. Le champ renvoie "phones/{E.164}/agentMessages/{messageId}", où {E.164} est le numéro de téléphone de l'utilisateur au format E.164 et {messageId} est l'ID attribué par l'agent au message de l'agent.

sendTime

string (Timestamp format)

Ce champ est défini par la plate-forme RCS for Business. Ne l'incluez pas lorsque vous créez un message d'agent. Le champ indique l'heure à laquelle le message est envoyé à l'utilisateur.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

contentMessage

object (AgentContentMessage)

Contenu du message de l'agent.

messageTrafficType

enum (MessageTrafficType)

Type de trafic des messages.

richMessageClassification

object (RichMessageClassification)

Uniquement en sortie. Classe le message selon le modèle de facturation américain. Pour en savoir plus sur chaque type de classification, consultez le guide sur le modèle de facturation aux États-Unis. Ce champ n'est renseigné que pour les numéros de téléphone américains.

totalPayloadSizeBytes

string (int64 format)

Uniquement en sortie. Taille totale de la charge utile du message en octets. La charge utile comptabilise toutes les pièces jointes d'un message RCS for Business (vidéo, images, PDF, etc.), à l'exception du texte du message ou des suggestions. Actuellement, ce champ n'est renseigné que pour les numéros de téléphone américains.

carrier

string

Uniquement en sortie. Informations sur l'opérateur auquel appartient le numéro de téléphone de l'utilisateur, d'après les backends Google RCS. Actuellement, ce champ n'est renseigné que pour les numéros de téléphone américains.

Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
expireTime

string (Timestamp format)

Facultatif. Code temporel en UTC du moment où cette ressource est considérée comme expirée. Doit être postérieure d'au moins six secondes à l'envoi du message. Si un code temporel futur inférieur à six secondes après l'envoi est spécifié, la plate-forme l'ajuste automatiquement à six secondes. Tout code temporel antérieur ou égal à l'heure d'envoi du message renvoie une erreur 400 INVALID_ARGUMENT. Cette valeur est renvoyée dans le résultat si expireTime ou ttl a été défini dans la requête et reflète les ajustements apportés à la valeur.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

ttl

string (Duration format)

Facultatif. Uniquement en entrée. Durée de vie d'un message avant sa révocation automatique. La valeur minimale est de six secondes. Si une durée positive inférieure à six secondes est spécifiée, la plate-forme l'ajuste automatiquement à six secondes et reflète la valeur ajustée dans le champ expireTime de la réponse. Toute durée non positive (égale ou inférieure à zéro) renvoie une erreur 400 INVALID_ARGUMENT.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

Fin des champs mutuellement exclusifs.

AgentContentMessage

Contenu d'un message envoyé par l'agent à un utilisateur.

Représentation JSON
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
Champs
suggestions[]

object (Suggestion)

Liste des réponses suggérées et des actions suggérées qui s'affichent sous la forme d'une liste de chips de suggestion après le message de l'agent associé. 11 suggestions maximum.

Les chips ne s'affichent que lorsque le message de l'agent associé est le message le plus récent de la conversation (y compris les messages de l'agent et de l'utilisateur). L'utilisateur peut appuyer sur une réponse suggérée pour envoyer la réponse textuelle à l'agent ou sur une action suggérée pour lancer une action native sur l'appareil.

Il existe deux types de modèles de suggestion : persistants et temporaires. Pour en savoir plus, consultez Suggestions.

Contenu du message de l'agent. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
text

string

Texte encodé en UTF-8. 3 072 caractères maximum.

fileName
(deprecated)

string

Nom unique d'un fichier. La plate-forme RCS for Business renvoie un nom de fichier lorsqu'un agent importe un fichier. Obsolète. Remplacé par uploadedRbmFile ci-dessous.

uploadedRbmFile

object (UploadedRbmFile)

Contient les identifiants d'un fichier et d'une miniature qui ont été importés sur le serveur RCS for Business et diffusés par celui-ci.

richCard

object (RichCard)

Une carte enrichie autonome.

contentInfo

object (ContentInfo)

Informations sur un fichier, y compris l'URL du fichier et l'URL de sa miniature.

La plate-forme RCS for Business diffuse du contenu à partir d'un cache, mais un agent peut forcer la plate-forme RCS for Business à récupérer une nouvelle version du contenu et à actualiser le cache.

Fin des champs mutuellement exclusifs.

UploadedRbmFile

Message contenant des informations sur le fichier et la miniature

Représentation JSON
{
  "fileName": string,
  "thumbnailName": string
}
Champs
fileName

string

Nom du fichier, renvoyé par la plate-forme RCS for Business lors de l'importation du fichier.

thumbnailName

string

Nom de la miniature, renvoyé par la plate-forme RCS for Business lors de l'importation de la miniature.

RichCard

Une carte enrichie autonome ou un carrousel de cartes enrichies envoyé par l'agent à l'utilisateur.

Représentation JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of mutually exclusive fields.
}
Champs
Carte autonome ou carrousel de cartes. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
carouselCard

object (CarouselCard)

Carrousel de cartes.

standaloneCard

object (StandaloneCard)

Carte autonome.

Fin des champs mutuellement exclusifs.

CarouselCard

Carrousel de cartes.

Représentation JSON
{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
Champs
cardWidth

enum (CarouselCard.CardWidth)

Largeur des fiches du carrousel.

cardContents[]

object (CardContent)

Liste des contenus de chaque fiche du carrousel. Un carrousel peut comporter entre 2 et 10 fiches.

CarouselCard.CardWidth

Largeur des fiches du carrousel.

Enums
CARD_WIDTH_UNSPECIFIED Non spécifié.
SMALL 120 DP.
MEDIUM 232 dp.

CardContent

Contenu de la carte

Représentation JSON
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
Champs
title

string

(Facultatif) Titre de la fiche. 200 caractères maximum.

description

string

(Facultatif) Description de la fiche. 2 000 caractères maximum.

media

object (Media)

(Facultatif) Contenu multimédia (image, GIF, vidéo, PDF) à inclure dans la fiche.

suggestions[]

object (Suggestion)

(Facultatif) Liste de suggestions à inclure dans la fiche. Quatre suggestions maximum.

Contenus multimédias

Fichier multimédia dans une carte enrichie.

Représentation JSON
{
  "height": enum (Media.Height),
  "contentDescription": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of mutually exclusive fields.
}
Champs
height

enum (Media.Height)

Hauteur du contenu multimédia dans une fiche enrichie avec une mise en page verticale. Pour une carte autonome avec une mise en page horizontale, utilisez TALL au lieu de HEIGHT_UNSPECIFIED pour assurer la compatibilité avec iOS.

contentDescription

string

Facultatif. Décrit le contenu multimédia pour l'accessibilité, en fournissant un texte alternatif. Accepte jusqu'à 200 caractères de texte brut.

Contenu multimédia : voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
fileName
(deprecated)

string

Nom unique du fichier, renvoyé par la plate-forme RCS for Business lors de l'importation du fichier. Obsolète. Remplacé par uploadedRbmFile ci-dessous.

uploadedRbmFile

object (UploadedRbmFile)

Contient les identifiants d'un fichier et d'une miniature qui ont été importés sur le serveur RCS for Business et diffusés par celui-ci.

contentInfo

object (ContentInfo)

Informations sur un fichier, y compris l'URL du fichier et l'URL de sa miniature.

La plate-forme RCS for Business diffuse du contenu à partir d'un cache, mais un agent peut forcer la plate-forme RCS for Business à récupérer une nouvelle version du contenu et à actualiser le cache.

Fin des champs mutuellement exclusifs.

ContentInfo

Message contenant les informations sur le contenu.

Représentation JSON
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}
Champs
fileUrl

string

URL du fichier accessible publiquement. La plate-forme RCS for Business détermine le type MIME du fichier à partir du champ "content-type" des en-têtes HTTP lorsqu'elle récupère le fichier. Le champ "content-type" doit être présent et exact dans la réponse HTTP de l'URL. Taille de fichier maximale recommandée : 100 Mo.

Remarque : Les redirections dans les URL de fichiers ne sont pas acceptées. Veuillez utiliser CreateFileRequest si une redirection est nécessaire.

thumbnailUrl

string

(Facultatif, pour les fichiers image, audio et vidéo uniquement) URL de la miniature accessible au public. Taille maximale de 100 ko.

Si vous ne fournissez pas d'URL de miniature, la plate-forme RCS for Business affiche une miniature d'espace réservé vide jusqu'à ce que l'appareil de l'utilisateur télécharge le fichier. Selon les paramètres de l'utilisateur, il est possible que le fichier ne se télécharge pas automatiquement et que l'utilisateur doive appuyer sur un bouton de téléchargement.

Remarque : Les redirections dans les URL de fichiers ne sont pas acceptées. Veuillez utiliser CreateFileRequest si une redirection est nécessaire.

forceRefresh

boolean

Si ce paramètre est défini, la plate-forme RCS for Business récupère le fichier et la miniature à partir des URL spécifiées, même si elle dispose de copies mises en cache du fichier (et/ou de la miniature).

Media.Height

Hauteur du support

Enums
HEIGHT_UNSPECIFIED Non spécifié.
SHORT 112 DP.
MEDIUM 168 dp.
TALL 264 dp.

Suggestion

Réponse suggérée ou action suggérée incluse dans une carte enrichie ou dans une liste de chips de suggestion.

Représentation JSON
{
  "suggestionDisplay": enum (Suggestion.SuggestionDisplay),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of mutually exclusive fields.
}
Champs
suggestionDisplay

enum (Suggestion.SuggestionDisplay)

Facultatif. Contrôle le comportement d'affichage de la suggestion. Applicable uniquement aux messages en texte brut envoyés aux clients Google Messages (version 20260225.00 ou ultérieure). Ce champ ne doit être défini que sur les suggestions autonomes associées à des messages en texte brut. Le serveur rejettera le message si ce champ est appliqué aux suggestions dans les fiches enrichies ou aux suggestions autonomes avec des transferts de fichiers. Ce paramètre n'est sérialisé que pour Google Messages. Il est ignoré par les autres clients (comme iOS ou Samsung).

Une réponse ou une action suggérée. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
reply

object (SuggestedReply)

Les utilisateurs peuvent appuyer sur une réponse suggérée pour envoyer la réponse textuelle à l'agent.

action

object (SuggestedAction)

Les utilisateurs peuvent appuyer sur une action suggérée pour lancer l'action native correspondante sur l'appareil.

Fin des champs mutuellement exclusifs.

SuggestedReply

Lorsque l'utilisateur appuie dessus, la réponse textuelle est renvoyée à l'agent.

Représentation JSON
{
  "text": string,
  "postbackData": string
}
Champs
text

string

Texte affiché dans la réponse suggérée et renvoyé à l'agent lorsque l'utilisateur appuie dessus. 25 caractères au maximum.

postbackData

string

Charge utile encodée en base64 que l'agent reçoit dans un événement utilisateur lorsque l'utilisateur appuie sur la réponse suggérée.

SuggestedAction

Lorsque l'utilisateur appuie dessus, l'action native correspondante est lancée sur l'appareil.

Représentation JSON
{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of mutually exclusive fields.
}
Champs
text

string

Texte affiché dans l'action suggérée. 25 caractères au maximum.

postbackData

string

Charge utile (encodée en base64) qui sera envoyée à l'agent dans l'événement utilisateur qui se produit lorsque l'utilisateur appuie sur l'action suggérée. 2 048 caractères maximum.

fallbackUrl

string

(Facultatif) URL de remplacement à utiliser si un client n'est pas compatible avec une action suggérée. Les URL de remplacement s'ouvrent dans de nouvelles fenêtres de navigateur. Il doit s'agir d'un URI valide, tel que défini dans la RFC 3986. 2 048 caractères maximum.

Action native lancée sur l'appareil lorsque l'utilisateur appuie sur l'action suggérée. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
dialAction

object (DialAction)

Ouvre l'application de numérotation par défaut de l'utilisateur avec le numéro de téléphone spécifié par l'agent.

viewLocationAction

object (ViewLocationAction)

Ouvre l'application de cartographie par défaut de l'utilisateur et sélectionne l'emplacement spécifié par l'agent ou effectue une recherche autour de l'emplacement de l'utilisateur en fonction d'une requête spécifiée par l'agent.

createCalendarEventAction

object (CreateCalendarEventAction)

Ouvre l'application d'agenda par défaut de l'utilisateur et lance le flux de création d'un événement d'agenda avec les données d'événement spécifiées par l'agent préremplies.

openUrlAction

object (OpenUrlAction)

Ouvre l'application de navigateur Web par défaut de l'utilisateur à l'URL indiquée. Si l'utilisateur a installé une application enregistrée comme gestionnaire par défaut de l'URL, celle-ci s'ouvrira à la place, et son icône sera utilisée dans l'UI de l'action suggérée.

shareLocationAction

object (ShareLocationAction)

Ouvre le sélecteur de position de l'application RCS pour que l'utilisateur puisse choisir une position à envoyer à l'agent.

Fin des champs mutuellement exclusifs.

DialAction

Ouvre l'application de numérotation par défaut de l'utilisateur avec le numéro de téléphone spécifié par l'agent.

Représentation JSON
{
  "phoneNumber": string
}
Champs
phoneNumber

string

Numéro de téléphone au format E.164, par exemple +12223334444.

ViewLocationAction

Ouvre l'application de cartographie par défaut de l'utilisateur et sélectionne l'emplacement spécifié par l'agent ou effectue une recherche autour de l'emplacement de l'utilisateur en fonction d'une requête spécifiée par l'agent.

Représentation JSON
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
Champs
latLong

object (LatLng)

(Facultatif) Latitude et longitude de l'emplacement spécifié.

label

string

(Facultatif) Libellé du repère placé à l'emplacement latLong.

query

string

(Facultatif) Au lieu de spécifier une valeur latLong (et éventuellement un libellé), l'agent peut spécifier une chaîne de requête. Pour les applications de cartographie par défaut qui prennent en charge la fonctionnalité de recherche (y compris Google Maps), appuyer sur cette suggestion d'action entraîne une recherche de lieu centrée sur la position actuelle de l'utilisateur. Si la requête est suffisamment spécifique, les agents peuvent l'utiliser pour sélectionner n'importe quel emplacement dans le monde.

Par exemple, si vous définissez la chaîne de requête sur "Growing Tree Bank", tous les établissements Growing Tree Bank situés à proximité de l'utilisateur s'afficheront. Si vous définissez la chaîne de requête sur "1600 Amphitheater Parkway, Mountain View, CA 94043", cette adresse spécifique sera sélectionnée, quel que soit l'emplacement de l'utilisateur.

LatLng

Objet représentant une paire latitude/longitude. Cette valeur est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.

Représentation JSON
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].

longitude

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

CreateCalendarEventAction

Ouvre l'application d'agenda par défaut de l'utilisateur et lance le flux de création d'un événement d'agenda avec les données d'événement spécifiées par l'agent préremplies.

Représentation JSON
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
Champs
startTime

string (Timestamp format)

Heure de début de l'événement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Heure de fin de l'événement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

title

string

Titre de l'événement 100 caractères au maximum.

description

string

Description de l'événement. 500 caractères maximum.

OpenUrlAction

Ouvre l'application de navigateur Web par défaut de l'utilisateur à l'URL spécifiée. Si l'utilisateur a installé une application enregistrée comme gestionnaire par défaut de l'URL, celle-ci s'ouvrira à la place, et son icône sera utilisée dans l'UI de l'action suggérée.

Représentation JSON
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
Champs
url

string

URL à ouvrir. À compter du 1er novembre 2025, le schéma d'URL devra être https:// ou http://. Les requêtes API utilisant d'autres schémas (par exemple, tel:, mailto:, sms:) seront refusées avec une erreur 400 (requête incorrecte) après cette date. L'URL doit être un URI valide, tel que défini dans la norme RFC 3986. 2 048 caractères maximum.

application

enum (OpenUrlApplication)

URL ouvrant l'application, le navigateur ou la WebView. Pour vérifier si l'appareil d'un utilisateur est compatible avec le mode WebView, commencez par effectuer une vérification des fonctionnalités. Pour en savoir plus, consultez la documentation : https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities.

webviewViewMode

enum (WebviewViewMode)

Mode d'affichage pour WebView.

description

string

Description d'accessibilité pour la vue Web.

OpenUrlApplication

Type de l'application d'ouverture de l'URL

Enums
OPEN_URL_APPLICATION_UNSPECIFIED Non spécifié, l'ouverture se fera dans le navigateur.
BROWSER Utilisez un navigateur pour ouvrir l'URL.
WEBVIEW Ouvrir l'URL dans une fenêtre WebView intégrée

WebviewViewMode

Type de mode d'affichage de la vue Web.

Enums
WEBVIEW_VIEW_MODE_UNSPECIFIED Non spécifié. Pour utiliser WebView, vous devez spécifier un mode d'affichage.
FULL Nécessite une superposition plein écran avec la conversation du chatbot étiquetée dans la barre d'état.
HALF Nécessite une superposition sur la moitié de l'écran.
TALL Nécessite une superposition d'écran aux trois quarts.

ShareLocationAction

Ce type ne comporte aucun champ.

Ouvre le sélecteur de position de l'application RCS pour que l'utilisateur puisse choisir une position à renvoyer à l'agent.

Suggestion.SuggestionDisplay

Comportement d'affichage des suggestions de texte autonomes.

Enums
SUGGESTION_DISPLAY_UNSPECIFIED

Les clients appliquent le comportement d'affichage par défaut :

  • Google Messages pour les messages autonomes en texte brut : les suggestions disparaissent après l'envoi ou la réception de nouveaux messages.
  • iOS pour les messages en texte brut autonomes : les suggestions ne disparaissent que lorsque l'utilisateur appuie dessus.
  • Tous les clients pour les cartes enrichies : les suggestions sont toujours persistantes. Définir suggestionDisplay sur les cartes enrichies entraînera une erreur 400.
PERSISTENT La suggestion reste visible dans la bulle de message, même lorsque de nouveaux messages sont ajoutés à la conversation.

StandaloneCard

Fiche autonome

Représentation JSON
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
Champs
cardOrientation

enum (StandaloneCard.CardOrientation)

Orientation de la carte.

thumbnailImageAlignment

enum (StandaloneCard.ThumbnailImageAlignment)

Alignement de l'aperçu d'image pour les fiches autonomes avec une mise en page horizontale.

cardContent

object (CardContent)

Contenu de la fiche.

StandaloneCard.CardOrientation

Orientation de la carte.

Enums
CARD_ORIENTATION_UNSPECIFIED Non spécifié.
HORIZONTAL

Mise en page horizontale.

Si le champ object(CardContent) d'une carte enrichie horizontale contient le champ media, il doit également inclure au moins un champ title, description ou suggestions[].

VERTICAL Mise en page verticale.

StandaloneCard.ThumbnailImageAlignment

Alignement de l'aperçu d'image pour les fiches autonomes avec une mise en page horizontale.

Enums
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED Non spécifié.
LEFT L'aperçu du fichier est aligné à gauche.
RIGHT L'aperçu du fichier est aligné à droite.

MessageTrafficType

Types de trafic de messages acceptés. L'énumération sera étendue pour prendre en charge d'autres types de trafic. Notez que même si le cas d'utilisation de l'agent peut fournir des conseils sur le type de trafic à utiliser, il n'y a pas d'application de l'API sur leur relation.

Enums
MESSAGE_TRAFFIC_TYPE_UNSPECIFIED Comportement par défaut : le type de trafic des messages est déterminé par le cas d'utilisation de l'agent. Mettez à jour le type de trafic si nécessaire en fonction du contenu du message. Pour les agents multi-usage, aucune valeur par défaut n'est fournie. Le type de trafic doit être défini manuellement (par exemple, TRANSACTION, PROMOTION).
AUTHENTICATION Pour les messages d'authentification (recommandé pour le cas d'utilisation de l'agent OTP).
TRANSACTION Pour les messages transactionnels (recommandé pour les cas d'utilisation d'agents transactionnels ou multi-usages).
PROMOTION Pour les messages promotionnels (recommandé pour les cas d'utilisation d'agents promotionnels ou multi-usages).
SERVICEREQUEST Pour les messages concernant des services que l'utilisateur a accepté de recevoir (recommandé pour les cas d'utilisation d'agents OTP, transactionnels, promotionnels ou multi-usages).
ACKNOWLEDGEMENT Pour les messages qui confirment la demande de désabonnement de l'utilisateur (recommandé pour les cas d'utilisation d'agent OTP, transactionnel, promotionnel ou multi-usage).

RichMessageClassification

Pour la facturation aux États-Unis uniquement : détails sur les classifications de messages utilisées pour la facturation.

Représentation JSON
{
  "classificationType": enum (RichMessageClassificationType),
  "segmentCount": integer
}
Champs
classificationType

enum (RichMessageClassificationType)

segmentCount

integer

Nombre de segments de 160 octets pour le texte du message, toujours arrondi à l'entier supérieur.

Calculé à partir de la longueur totale en octets UTF-8 du contenu textuel uniquement. Les données des réponses ou actions suggérées sont exclues.

Par exemple, un message de 300 octets a un segmentCount de 2.

Ce champ n'est renseigné que pour les types RICH_MESSAGE.

RichMessageClassificationType

Pour la facturation aux États-Unis uniquement : spécifie la classification du message pour la facturation.

Important : Les opérateurs américains fixent le prix des types de messages facturables décrits sur cette page. Les opérateurs américains déterminent également les frais finaux facturés au développeur pour l'envoi de messages RCS for Business. Pour en savoir plus sur les tarifs ou les informations de facturation, veuillez contacter les représentants de l'opérateur concerné.

Enums
RICH_MESSAGE_CLASSIFICATION_TYPE_UNSPECIFIED Non spécifié
RICH_MESSAGE Le message est classé comme ENRICHI dans les conditions suivantes : 1. Il ne contient pas de cartes enrichies. 2. Il ne contient pas de pièces jointes. 3. Toutes les actions suggérées qu'elle contient doivent être une action "Composer" ou "Ouvrir l'URL" qui n'utilise pas de WebView.
RICH_MEDIA_MESSAGE Tout message qui ne répond pas aux critères RICH_MESSAGE. Cela inclut les messages contenant une fiche enrichie, un fichier multimédia ou toute action suggérée autre que "Composer un numéro" ou "Ouvrir l'URL dans le navigateur".
SUGGESTED_ACTION_CLICK Représente l'appui d'un utilisateur sur une action suggérée (et non sur une réponse suggérée). Cette classification ne s'applique qu'aux actions de l'utilisateur et n'apparaît que dans la charge utile UserMessage d'un webhook. Il ne s'applique pas aux messages A2P.

Méthodes

create

Envoie un message de l'agent à un utilisateur.

delete

Révoque un message d'agent qui a été envoyé, mais pas encore distribué.