REST Resource: conversations.messages

Ressource: Message

Message dans une conversation entre un agent et un utilisateur.

Représentation JSON 
{
  "name": string,
  "messageId": string,
  "representative": {
    object (Representative)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "fallback": string,
  "containsRichText": boolean,

  // Union field content can be only one of the following:
  "text": string,
  "image": {
    object (Image)
  },
  "richCard": {
    object (RichCard)
  }
  // End of list of possible types for union field content.
}
Champs
name

string

Nom du message, tel que défini par Business Messages. Renvoie "conversations/{conversationId}/messages/{messageId}", où {conversationId} correspond à l'ID unique de la conversation et {messageId} à l'ID unique du message.
messageId

string

Obligatoire. Identifiant unique du message, attribué par l'agent. Si un message tente d'utiliser le même identifiant messageId qu'un message précédent, sa distribution peut s'en trouver affectée.
representative

object (Representative)

Informations sur le représentant (humain ou chatbot) qui a envoyé le message
suggestions[]

object (Suggestion)

Liste de réponses suggérées qui s'affiche sous la forme d'une liste de chips de suggestion à la suite du message associé. 13 suggestions au maximum.

Les chips ne s'affichent que lorsque le message associé est le message le plus récent de la conversation (qu'il s'agisse de messages de l'agent ou de l'utilisateur). L'utilisateur peut appuyer sur une réponse suggérée pour envoyer la réponse textuelle à l'agent.
fallback

string

Facultatif. Texte de remplacement qui s'affiche si l'appareil de l'utilisateur n'est pas compatible avec le type ou le contenu du message. 3 072 caractères maximum.
containsRichText

boolean

Facultatif. Si la valeur est true, cela signifie que le message contient du texte enrichi. Si le message présente une mise en forme non valide, Business Messages affiche une erreur.
Champ d'union content. Contenu d'un message. content ne peut être qu'un des éléments suivants :
text

string

SMS. 3 072 caractères maximum.
image

object (Image)

Message avec image.
richCard

object (RichCard)

Message de carte enrichie.

Image

Image.

Représentation JSON 
{

  // Union field content can be only one of the following:
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
Champs
Champ d'union content. Contenu de l'image. content ne peut être qu'un des éléments suivants :
contentInfo

object (ContentInfo)

Informations sur une image, y compris l'URL de l'image et l'URL de sa vignette.

ContentInfo

Message contenant les informations sur le contenu.

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

string

URL du fichier accessible publiquement. La plate-forme 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 précis dans la réponse HTTP à partir de l'URL.

5 Mo maximum.

Types de contenus acceptés: image/jpeg, image/jpg, image/png, image/webp
thumbnailUrl

string

Facultatif. URL de la vignette accessible au public

Si vous ne fournissez pas d'URL de vignette, la plate-forme affiche une vignette d'espace réservé vide jusqu'à ce que l'appareil de l'utilisateur télécharge le fichier.

25 Ko maximum.

Types de contenus acceptés: image/jpeg, image/jpg, image/png, image/webp
forceRefresh

boolean

Si cette option est définie, la plate-forme récupère le fichier et la vignette à partir des URL spécifiées, même si elle a mis en cache des copies du fichier (et/ou de la vignette).
altText

string

Texte décrivant les détails du contenu multimédia à des fins d'accessibilité.

RichCard

Carte enrichie autonome ou carrousel de cartes enrichies envoyées par l'agent à l'utilisateur.

Représentation JSON 
{

  // Union field card can be only one of the following:
  "standaloneCard": {
    object (StandaloneCard)
  },
  "carouselCard": {
    object (CarouselCard)
  }
  // End of list of possible types for union field card.
}
Champs
Champ d'union card. Types de cartes enrichies possibles. card ne peut être qu'un des éléments suivants :
standaloneCard

object (StandaloneCard)

Carte autonome.
carouselCard

object (CarouselCard)

Carrousel de fiches

StandaloneCard

Carte autonome.

Représentation JSON 
{
  "cardContent": {
    object (CardContent)
  }
}
Champs
cardContent

object (CardContent)

Contenu de la fiche.

CardContent

Contenu de la fiche.

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 à inclure dans la fiche.
suggestions[]

object (Suggestion)

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

Multimédia

Fichier multimédia dans une carte enrichie.

Représentation JSON 
{
  "height": enum (Height),

  // Union field content can be only one of the following:
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
Champs
height

enum (Height)

Hauteur du contenu multimédia dans une carte enrichie.
Champ d'union content. Contenu multimédia. content ne peut être qu'un des éléments suivants :
contentInfo

object (ContentInfo)

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

Hauteur

Hauteur du support

Enums
HEIGHT_UNSPECIFIED Non spécifié.
SHORT 112 DP.
MEDIUM 168 DP.
TALL 264 DP. Non disponible pour les carrousels de cartes enrichies lorsque la largeur de la fiche est définie sur SMALL.

Suggestion

Suggestion dans une liste de chips.

Représentation JSON 
{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  },
  "liveAgentRequest": {
    object (LiveAgentRequest)
  },
  "authenticationRequest": {
    object (AuthenticationRequest)
  }
  // End of list of possible types for union field option.
}
Champs
Champ d'union option. Réponse suggérée. option ne peut être qu'un des éléments suivants :
reply

object (SuggestedReply)

Suggestion invitant l'utilisateur à répondre avec le texte spécifié.
action

object (SuggestedAction)

Action suggérée qui lance une action native sur l'appareil.
liveAgentRequest

object (LiveAgentRequest)

Demande pour qu'un agent participe à la conversation.
authenticationRequest

object (AuthenticationRequest)

Requête permettant de lancer le flux d'authentification.

SuggestedReply

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

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

string

Texte qui s'affiche dans la réponse suggérée et qui est envoyé à l'agent lorsque l'utilisateur appuie dessus. 25 caractères maximum.
postbackData

string

Chaîne reçue par l'agent lorsqu'un utilisateur appuie sur la réponse suggérée. 2 048 caractères maximum.

SuggestedAction

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

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

  // Union field action can be only one of the following:
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "dialAction": {
    object (DialAction)
  }
  // End of list of possible types for union field action.
}
Champs
text

string

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

string

Chaîne reçue par l'agent lorsqu'un utilisateur appuie sur l'action suggérée. 2 048 caractères maximum.
Champ d'union action. Action native lancée sur l'appareil lorsque l'utilisateur appuie sur l'action suggérée. action ne peut être qu'un des éléments suivants :
openUrlAction

object (OpenUrlAction)

Ouvre l'URL spécifiée.
dialAction

object (DialAction)

Ouvre l'application Téléphone par défaut de l'utilisateur.

OpenUrlAction

Ouvre l'URL spécifiée.

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

string

URL

DialAction

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

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

string

Obligatoire. Numéro de téléphone spécifié, au format RFC 3966. Exemple : "+1-201-555-0123".

LiveAgentRequest

Ce type ne comporte aucun champ.

Lorsque l'utilisateur appuie sur ce bouton, une invitation à rejoindre la conversation est envoyée à un agent.

AuthenticationRequest

Requête d'authentification d'une conversation.

Représentation JSON 
{

  // Union field authentication_type can be only one of the following:
  "oauth": {
    object (Oauth)
  }
  // End of list of possible types for union field authentication_type.
}
Champs
Champ d'union authentication_type. Type d'authentification. authentication_type ne peut être qu'un des éléments suivants :
oauth

object (Oauth)

Détails de l'authentification via OAuth

Oauth

Détails de l'authentification via OAuth

Représentation JSON 
{
  "clientId": string,
  "codeChallenge": string,
  "scopes": [
    string
  ],
  "codeChallengeMethod": string
}
Champs
clientId

string

Obligatoire. ID de l'application qui demande une autorisation.
codeChallenge

string

Obligatoire. Question d'authentification du code utilisée pour échanger des jetons d'accès.
scopes[]

string

Obligatoire. Tableau spécifiant les champs d'application de la requête.
codeChallengeMethod

string

Facultatif. Méthode d'authentification par code utilisée pour générer le défi de code. Si ce paramètre est omis, le serveur suppose que la valeur est plain.

CarouselCard

Carrousel de fiches

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

enum (CardWidth)

Largeur des fiches dans le carrousel.
cardContents[]

object (CardContent)

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

CardWidth

Largeur des fiches dans le carrousel.

Enums
CARD_WIDTH_UNSPECIFIED Non spécifié
SMALL 136 DP. Impossible d'inclure des contenus multimédias de grande taille.
MEDIUM 280 DP.

Méthodes

create

 Envoie un message à un utilisateur à partir d'un agent.

updateReceipt

 Envoie une confirmation d'un message d'un agent à un utilisateur.