Passer au contenu principal
Les API Connect360 permettent à un backend fiable de créer des conversations, d’envoyer des messages, de télécharger des pièces jointes et de déclencher des réponses AI. Utilisez-les pour :
  • Widgets de discussion sur le site Web.
  • Portails de support client.
  • Commandez des expériences d’assistance.
  • Applications externes qui doivent créer ou mettre à jour des conversations Connect360.

Conversations

Créez ou réutilisez des conversations clients et organisez des fils de discussion d’assistance.

Messages

Envoyez des messages, répertoriez l’historique des fils de discussion et travaillez avec le contenu des conversations.

Pièces jointes

Téléchargez des fichiers et utilisez les pièces jointes dans les messages.

AI Flux

Déclenchez des réponses assistées par AI pour les expériences de chat prises en charge.

Conversations avec les invités

Permettez aux visiteurs externes du site Web de démarrer ou de poursuivre une conversation en toute sécurité.

Authentification

Envoyez les clés API à partir d’un backend de confiance avant d’appeler Connect360.

​
Styles API

Connect360 utilise à la fois les points de terminaison typés SDK et REST. Utilisez le SDK pour les conversations et les messages : 
plato.v1.connect.getOrCreateConversation.mutate(...)
plato.v1.connect.send.mutate(...)
plato.v1.connect.listMessages.query(...)
Utilisez REST pour le téléchargement de pièces jointes dans le navigateur et la diffusion en continu des réponses AI : 
POST /api/v1/connect/attachments
GET  /api/v1/connect/assets/[...key]
POST /api/v1/connect/ai-stream

​
Autorisations requises

ActionAutorisation
Lire les conversations et les messagesconnect360:conversation:read
Créez des conversations, envoyez des messages, téléchargez des pièces jointes, déclenchez AIconnect360:conversation:engage
Supprimer des conversationsconnect360:conversation:delete
La clé API doit appartenir à un membre de l’espace de travail.

​
Modèle de conversation

Les conversations Connect360 peuvent être organisées de manière hiérarchique. Les conversations de haut niveau constituent le fil conducteur avec un client ou un groupe. Les sous-conversations sont des fils de discussion enfants sous une conversation de niveau supérieur. Ils sont utiles pour les fils de discussion de projet, les fils de discussion de support de commande ou les discussions sur un sujet spécifique. Les messages sont toujours envoyés à un conversationId, qui peut être soit une conversation de niveau supérieur, soit une sous-conversation.

​
Identité du client

Pour le site Web ou les utilisateurs externes, transmettez un objet customer ou un customerId existant. Ne créez pas de visiteurs de site Web en tant que membres de l’espace de travail. 
customer: {
  externalId: "website_user_123",
  name: "Jane Customer",
  email: "[email protected]",
  phone: "+971500000000",
}
Plato peut faire correspondre les clients par identifiant externe, e-mail ou téléphone.

​
Canaux du site Web

Les intégrations de sites Web peuvent passer channelIdentifier. 
channelIdentifier: "example.com"
Plato normalise l’identifiant, crée ou réutilise un canal de site Web et l’attache à la conversation. Utilisez l’hébergeur actuel du site Web, tel que example.com ou shop.example.com.