LiveChat
LiveChat est un logiciel de service clientèle en ligne avec prise en charge dynamique, logiciels de support technique et fonctionnalités d’analytique web.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL | https://www.livechat.com/ |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://www.livechat.com/ |
| Politique de confidentialité | https://www.livechat.com/legal/privacy-policy/ |
| Categories | La communication |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| ID d’entité hérité (déconseillé) | ficelle | ID d’entité (adresse e-mail) utilisé uniquement par les opérations de l’API LiveChat v2 déconseillées. | |
| ID de compte | ficelle | ID de compte (GUID) affiché sur la page Jetons d’accès personnels LiveChat. Les nouvelles opérations de connecteur (V2) utilisent cette valeur avec l’API LiveChat v3.6. | Vrai |
| Jeton d’accès personnel | securestring | Jeton d’accès personnel non codé complet pour ce compte. | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Agents de liste (déconseillé) [DÉPRÉCIÉ] |
Cette opération déconseillée retourne des agents à l’aide de l’API LiveChat v2. Utilisez les agents de liste (V2) à la place. |
| Créer un agent (déconseillé) [DÉPRÉCIÉ] |
Cette opération déconseillée crée un agent à l’aide de l’API LiveChat v2. Utilisez à la place Créer un agent (V2). |
| Créer un agent (V2) |
Crée un agent à l’aide de l’API LiveChat v3.6. L’agent peut nécessiter une approbation en fonction des étendues de jeton d’accès personnel et de l’abonnement LiveChat. |
| Créer un ticket (déconseillé) [DÉPRÉCIÉ] |
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée. |
| Obtenir un ticket (déconseillé) [DÉPRÉCIÉ] |
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée. |
| Répertorier les agents (V2) |
Retourne tous les agents dans la licence LiveChat à l’aide de l’API LiveChat v3.6. Le jeton d’accès personnel nécessite l’étendue agents--all :ro. |
| Répertorier les tickets (déconseillés) [DÉCONSEILLÉ] |
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée. |
| Supprimer un agent (déconseillé) [DÉPRÉCIÉ] |
Cette opération déconseillée supprime un agent à l’aide de l’API LiveChat v2. Utilisez plutôt Supprimer un agent (V2). |
| Supprimer un agent (V2) |
Supprime un agent à l’aide de l’API LiveChat v3.6. La suppression d’un autre agent nécessite les étendues agents--all :rw et accounts--all :rw. |
| Ticket de mise à jour (déconseillé) [DÉCONSEILLÉ] |
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée. |
Agents de liste (déconseillé) [DÉPRÉCIÉ]
Cette opération déconseillée retourne des agents à l’aide de l’API LiveChat v2. Utilisez les agents de liste (V2) à la place.
Retours
Liste de tous les agents avec leurs détails.
- Objets
- ListAgents_Response
Créer un agent (déconseillé) [DÉPRÉCIÉ]
Cette opération déconseillée crée un agent à l’aide de l’API LiveChat v2. Utilisez à la place Créer un agent (V2).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Messagerie électronique
|
login | True | string | |
|
Nom
|
name | True | string | |
|
État de connexion
|
login_status | string | ||
|
Titre
|
job_title | string |
Valeurs par défaut : Agent de support. |
|
|
Autorisation
|
permission | string | ||
|
Mot de passe
|
password | string |
Longueur minimale 5. |
|
|
Nombre maximal de conversations
|
max_chats_count | string |
Limite des conversations simultanées. |
Retours
- Corps
- CreateAgent_Response
Créer un agent (V2)
Crée un agent à l’aide de l’API LiveChat v3.6. L’agent peut nécessiter une approbation en fonction des étendues de jeton d’accès personnel et de l’abonnement LiveChat.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’agent
|
id | True | string |
ID de l’agent, généralement l’adresse e-mail de l’agent. |
|
Nom
|
name | True | string |
Nom de l’agent. |
|
Rôle
|
role | string |
La création d’un rôle supérieur à la normale nécessite l’étendue accounts.roles.lc--all :rw. |
|
|
État de connexion
|
login_status | string | ||
|
Fonction
|
job_title | string | ||
|
Mobile
|
mobile | string | ||
|
Nombre maximal de conversations
|
max_chats_count | integer | ||
|
Approbation en attente
|
awaiting_approval | boolean |
La définition de cette valeur sur false nécessite l’étendue private subscription.lc :rw. |
|
|
ID de groupe
|
id | True | integer | |
|
Priority
|
priority | True | string | |
|
Notifications
|
notifications | array of string | ||
|
Abonnements par e-mail
|
email_subscriptions | array of string | ||
|
Fuseau horaire
|
timezone | string |
Fuseau horaire utilisé par la planification du travail. |
|
|
Jour
|
day | True | string | |
|
Enabled
|
enabled | True | boolean | |
|
Start
|
start | True | string | |
|
Fin
|
end | True | string |
Créer un ticket (déconseillé) [DÉPRÉCIÉ]
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
E-mail du demandeur
|
True | string | ||
|
Nom du demandeur
|
name | string | ||
|
Sujet
|
subject | string | ||
|
ID du bénéficiaire
|
id | string | ||
|
Type de Source
|
type | string |
Choisir une source |
|
|
Source URL
|
url | string |
Si le type de source est une fenêtre de conversation. |
Retours
- Corps
- TicketResponse
Obtenir un ticket (déconseillé) [DÉPRÉCIÉ]
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | string |
ID du ticket |
Retours
- Corps
- TicketResponse
Répertorier les agents (V2)
Retourne tous les agents dans la licence LiveChat à l’aide de l’API LiveChat v3.6. Le jeton d’accès personnel nécessite l’étendue agents--all :ro.
Retours
Agents dans la licence LiveChat.
- Objets
- ListAgentsV2_Response
Répertorier les tickets (déconseillés) [DÉCONSEILLÉ]
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée.
Retours
- Objets
- ListTicketsResponse
Supprimer un agent (déconseillé) [DÉPRÉCIÉ]
Cette opération déconseillée supprime un agent à l’aide de l’API LiveChat v2. Utilisez plutôt Supprimer un agent (V2).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Messagerie électronique
|
login | True | string |
E-mail de l’agent. |
Retours
- Corps
- DeleteAgent_Response
Supprimer un agent (V2)
Supprime un agent à l’aide de l’API LiveChat v3.6. La suppression d’un autre agent nécessite les étendues agents--all :rw et accounts--all :rw.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’agent
|
id | True | string |
ID de l’agent à supprimer. |
Ticket de mise à jour (déconseillé) [DÉCONSEILLÉ]
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | string |
ID du ticket |
|
Message
|
message | string | ||
|
E-mail du demandeur
|
True | string | ||
|
Nom du demandeur
|
name | string | ||
|
Sujet
|
subject | string | ||
|
ID du bénéficiaire
|
id | string |
Choisissez un bénéficiaire. |
|
|
Type de Source
|
type | string |
Choisissez une source. |
|
|
Source URL
|
url | string |
Si le type de source est une fenêtre de conversation. |
Retours
- Corps
- TicketResponse
Déclencheurs
| Lorsqu’un ticket est créé (déconseillé) [DÉCONSEILLÉ] |
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée. |
| Lorsqu’une conversation démarre (déconseillée) [DÉCONSEILLÉE] |
Cette opération déconseillée utilise l’API LiveChat v2. |
| Lorsqu’une conversation se termine (déconseillée) [DÉCONSEILLÉE] |
Cette opération déconseillée utilise l’API LiveChat v2. |
Lorsqu’un ticket est créé (déconseillé) [DÉCONSEILLÉ]
Cette opération déconseillée utilise l’API LiveChat Tickets supprimée.
Retours
- Corps
- WebhookTicketResponse
Lorsqu’une conversation démarre (déconseillée) [DÉCONSEILLÉE]
Lorsqu’une conversation se termine (déconseillée) [DÉCONSEILLÉE]
Définitions
WebhookChatResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
E-mail de l’agent
|
chat.agents.login | string |
Adresse e-mail de l’agent. |
|
Nom de l’agent
|
chat.agents.name | string |
Nom de l’agent. |
|
Horodatage terminé
|
chat.ended_timestamp | string |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
events
|
chat.events | array of object |
Tableau d’événements. |
|
Texte de l’événement
|
chat.events.text | string |
Message associé à l’événement. |
|
Date-Time d’événements
|
chat.events.timestamp | string |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Type d'événement
|
chat.events.type | string |
Type d’événement. |
|
Type d’utilisateur d’événement
|
chat.events.user_type | string |
Type d’utilisateur. |
|
groups
|
chat.groups | array of integer | |
|
ID de groupe
|
chat.id | string |
Identificateur unique du groupe. |
|
Message
|
chat.messages | array of object |
Tableau de messages. |
|
ID de l’agent
|
chat.messages.agent_id | string |
ID unique de l’agent associé au message. |
|
Nom de l’auteur
|
chat.messages.author_name | string |
Nom de l’auteur du message.. |
|
Texto
|
chat.messages.text | string |
Corps du message. |
|
Date-Time envoyées
|
chat.messages.timestamp | string |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Type d’utilisateur
|
chat.messages.user_type | string |
Type de l’utilisateur qui envoie le message. |
|
Démarré Date-Time
|
chat.started_timestamp | string |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
URL
|
chat.url | string |
URL du site web où la conversation a démarré. |
|
ID d’événement
|
event_unique_id | string |
ID unique de l’événement associé à la conversation. |
|
Pré-sondage de conversation
|
pre_chat_survey | array of object |
Tableau de réponses d’enquête de pré-conversation. |
|
Réponse
|
pre_chat_survey.answer | string |
Réponse à l’enquête. |
|
ID d’enquête
|
pre_chat_survey.id | string |
ID d’enquête de pré-conversation. |
|
Question
|
pre_chat_survey.label | string |
Question d’enquête. |
|
Messagerie électronique
|
visitor.email | string |
Adresse e-mail du visiteur. |
|
Id
|
visitor.id | string |
ID unique du visiteur. |
|
Language
|
visitor.language | string |
Langue associée au compte du visiteur. |
|
Nom
|
visitor.name | string |
Nom du visiteur. |
|
Page
|
visitor.page_current | string |
Page web à partir de laquelle la conversation provient. |
WebhookTicketResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
ticket.assignee.id | string |
Identificateur unique de l’utilisateur. |
|
Nom
|
ticket.assignee.name | string |
Nom du bénéficiaire. |
|
events
|
ticket.events | array of object | |
|
Id
|
ticket.events.author.id | string |
ID unique de l’utilisateur. |
|
Nom
|
ticket.events.author.name | string |
Nom de l’auteur. |
|
Type
|
ticket.events.author.type | string |
Agent ou client. |
|
Date-Time d’événements
|
ticket.events.date | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Est privé
|
ticket.events.is_private | boolean |
True si l’événement est privé. |
|
Message
|
ticket.events.message | string |
Description de l’événement. |
|
Type
|
ticket.events.source.type | string |
Fenêtre de conversation, courrier ou lc2. |
|
URL
|
ticket.events.source.url | string |
URL du site web à partir duquel le ticket a été envoyé. |
|
Type d'événement
|
ticket.events.type | string |
Type d’événement qui a généré le ticket. |
|
Groupe
|
ticket.groups | array of object |
Détails du groupe associé. |
|
Id
|
ticket.groups.id | integer |
ID unique du groupe. |
|
Nom
|
ticket.groups.name | string |
Nom du groupe. |
|
Ticket Id
|
ticket.id | string |
ID unique du ticket. |
|
IP
|
ticket.requester.ip | string |
Adresse IP du demandeur. |
|
Messagerie électronique
|
ticket.requester.mail | string |
Adresse e-mail du demandeur. |
|
Nom
|
ticket.requester.name | string |
Nom du demandeur. |
|
Id
|
ticket.source.id | string |
ID unique de la source. |
|
Type
|
ticket.source.type | string |
Lc2, courrier, facebook, agent-app-manual ou chat-window. |
|
URL
|
ticket.source.url | string |
URL du site web où le ticket a été créé. |
|
Statut
|
ticket.status | string |
Ouvrez, attendez, résolvez ou courrier indésirable. |
|
Sujet
|
ticket.subject | string |
Brève description du ticket. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Création de Date-Time
|
date | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Ticket Id
|
id | string |
Identificateur unique du ticket. |
|
Date-Time modifié
|
modified | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
IP
|
requester.ip | string |
Adresse IP du demandeur. |
|
Messagerie électronique
|
requester.mail | string |
Adresse e-mail du demandeur. |
|
Nom
|
requester.name | string |
Nom complet du demandeur. |
|
Id
|
source.id | string |
Identificateur unique de la source. |
|
Type
|
source.type | string |
À partir d’une conversation, d’un courrier ou d’un lc2. |
|
URL
|
source.url | string |
Page web où le ticket a été créé. |
|
Statut
|
status | string |
Ouvrez, attendez, résolvez ou courrier indésirable. |
|
Sujet
|
subject | string |
Description de la source du ticket. |
TicketResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
currentGroup.id | integer |
ID unique du groupe. |
|
Nom
|
currentGroup.name | string |
Nom du groupe. |
|
Création de Date-Time
|
date | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
events
|
events | array of object | |
|
Id
|
events.author.id | string |
ID unique de l’utilisateur. |
|
Nom
|
events.author.name | string |
Nom de l’auteur. |
|
Type
|
events.author.type | string |
Agent ou client. |
|
Date-Time d’événements
|
events.date | date-time |
aaaa-MM-ddTHH :mm :ss.fffZ |
|
Est privé
|
events.is_private | boolean |
True si l’événement est privé. |
|
Message
|
events.message | string |
Description de l’événement. |
|
Type
|
events.source.type | string |
Fenêtre de conversation, courrier ou lc2. |
|
URL
|
events.source.url | string |
URL du site web à partir duquel le ticket a été envoyé. |
|
Type d'événement
|
events.type | string |
Type d’événement qui a généré le ticket. |
|
Groupe
|
groups | array of object |
Détails du groupe associé. |
|
Id
|
groups.id | integer |
ID unique du groupe. |
|
Nom
|
groups.name | string |
Nom du groupe. |
|
Ticket Id
|
id | string |
ID unique du ticket. |
|
IP
|
requester.ip | string |
Adresse IP du demandeur. |
|
Messagerie électronique
|
requester.mail | string |
Adresse e-mail du demandeur. |
|
Nom
|
requester.name | string |
Nom du demandeur. |
|
Id
|
source.id | string |
ID unique de la source. |
|
Type
|
source.type | string |
Lc2, courrier, facebook, agent-app-manual ou chat-window. |
|
URL
|
source.url | string |
URL du site web où le ticket a été créé. |
|
Statut
|
status | string |
Ouvrez, attendez, résolvez ou courrier indésirable. |
|
Sujet
|
subject | string |
Brève description du ticket. |
|
tags
|
tags | array of string |
ListAgentsV2_Response
Agents dans la licence LiveChat.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Objets
|
AgentV2 |
AgentV2
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de l’agent
|
id | string |
ID de l’agent, généralement l’adresse e-mail de l’agent. |
|
Nom
|
name | string |
Nom de l’agent. |
|
Avatar
|
avatar | string |
URL de l’avatar de l’agent. |
|
Rôle
|
role | string |
Rôle d’agent. |
|
État de connexion
|
login_status | string |
État de connexion de l’agent. |
|
Fonction
|
job_title | string |
Titre du travail de l’agent. |
|
Mobile
|
mobile | string |
Numéro mobile de l’agent. |
|
Nombre maximal de conversations
|
max_chats_count | integer |
Nombre maximal de conversations simultanées. |
|
Suspendu
|
suspended | boolean |
Indique si l’agent est suspendu. |
|
Approbation en attente
|
awaiting_approval | boolean |
Indique si l’agent attend l’approbation. |
|
groups
|
groups | array of AgentGroupV2 |
Groupes affectés à l’agent. |
AgentGroupV2
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de groupe
|
id | integer | |
|
Priority
|
priority | string |
ListAgents_Response
Liste de tous les agents avec leurs détails.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Avatar
|
avatar | string |
Chemin d’accès à l’image sur Amazon s3. |
|
Adresse e-mail de connexion
|
login | string |
Adresse e-mail de l’agent. |
|
Nom
|
name | string |
Nom de l’agent. |
|
Autorisation
|
permission | string |
Propriétaire, administrateur ou normal. |
CreateAgent_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Avatar
|
avatar | string |
Chemin d’accès à l’image sur Amazon s3. |
|
Tableau de groupes
|
groups | array of object |
La liste de tous les groupes dont l’agent fait partie. |
|
ID de groupe
|
groups.id | integer |
ID unique du groupe. |
|
Nom du groupe
|
groups.name | string |
Nom du groupe. |
|
Poste
|
job_title | string |
Agent de support par défaut. |
|
Messagerie électronique
|
login | string |
Adresse e-mail de l’agent. |
|
État de connexion
|
login_status | string |
Accepter des conversations ou ne pas accepter les conversations. |
|
Nombre maximal de conversations
|
max_chats_count | integer |
Limite des conversations simultanées. |
|
Nom
|
name | string |
Nom de l’agent. |
|
Autorisation
|
permission | string |
Propriétaire, administrateur ou normal |
|
Statut
|
status | string |
Accepter les conversations, ne pas accepter les conversations ou hors connexion. |