HubSpot Conversations V2 (éditeur indépendant) (préversion)
Les services de conversations HubSpot vous permettent de gérer et d’interagir avec la boîte de réception, les canaux et les messages des conversations.
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 | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| Messagerie électronique | ttaylor@hitachisolutions.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Troy Taylor |
| Site web | https://www.hubspot.com/products/crm/conversations |
| Politique de confidentialité | https://legal.hubspot.com/privacy-policy |
| Catégories | Marketing; Ventes et CRM |
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 |
|---|---|---|---|
| Jeton d’accès (sous la forme « Porteur YOUR_ACCESS_TOKEN ») | securestring | Jeton d’accès (sous la forme « Porteur YOUR_ACCESS_TOKEN ») pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Archive un thread |
Archive un seul thread. Le thread sera définitivement supprimé 30 jours après avoir été placé dans un état archivé. |
| Envoyer un message à un thread |
Envoyez un nouveau message sur un thread à l’horodatage actuel. |
| Générer un jeton |
Génère un nouveau jeton d’identification de visiteur. Ce jeton sera unique chaque fois que ce point de terminaison est appelé, même s’il est appelé avec la même adresse e-mail. Ce jeton est temporaire et expire après 12 heures. |
| Mettre à jour un thread |
Met à jour un thread unique. L’état d’un thread peut être mis à jour ou le thread peut être restauré. |
| Obtenir des acteurs |
Résolvez les identificateurs d’acteurs pour les acteurs et les participants sous-jacents. |
| Obtenir des boîtes de réception de conversations |
Récupérez une liste des boîtes de réception de conversations. |
| Obtenir des canaux |
Récupérez une liste de canaux. |
| Obtenir des comptes de canal |
Récupérez une liste de comptes de canal. |
| Obtenir des threads |
Récupérez une liste de threads. |
| Obtenir le contenu d’origine d’un seul message |
Retourne le texte d’origine complet et les corps de texte enrichi d’un message. Cela sera différent du texte et du texte enrichi dans le message lui-même si la troncationStatus du message n’est rien d’autre que NOT_TRUNCATED. |
| Obtenir l’historique des messages pour un thread |
Récupérez la liste de l’historique des messages pour un thread. |
| Obtenir un compte de canal unique |
Récupérez un compte de canal unique. |
| Obtenir un seul acteur |
Récupérer un seul acteur. |
| Obtenir un seul canal |
Récupérez un seul canal. |
| Obtenir un seul message |
Récupérez un message unique. |
| Obtenir un thread unique |
Récupère un thread unique. |
| Obtenir une boîte de réception de conversations unique |
Récupérer une boîte de réception de conversations unique. |
Archive un thread
Archive un seul thread. Le thread sera définitivement supprimé 30 jours après avoir été placé dans un état archivé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Thread ID
|
threadId | True | string |
Identificateur de thread. |
Retours
- response
- string
Envoyer un message à un thread
Envoyez un nouveau message sur un thread à l’horodatage actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Thread ID
|
threadId | True | string |
Identificateur de thread. |
|
Attachments
|
attachments | array of |
Objet pièces jointes. |
|
|
ID du compte de canal
|
channelAccountId | string |
Identificateur du compte de canal. |
|
|
ID de canal
|
channelId | string |
Identificateur de canal. |
|
|
Type
|
type | string |
Type. |
|
|
Valeur
|
value | string |
Valeur. |
|
|
ID d’acteur
|
actorId | string |
Identificateur de l’acteur. |
|
|
Nom
|
name | string |
Nom. |
|
|
Champ destinataire
|
recipientField | string |
Champ destinataire. |
|
|
Type
|
type | string |
Type. |
|
|
Valeur
|
value | string |
Valeur. |
|
|
ID d’acteur de l’expéditeur
|
senderActorId | string |
Identificateur de l’acteur de l’expéditeur. |
|
|
Texto
|
text | string |
Texte. |
|
|
Type
|
type | string |
Type. |
|
|
Format RTF (Rich Text Format)
|
richText | string |
Le texte rick. |
|
|
Sujet
|
subject | string |
Objet. |
Retours
- response
- string
Générer un jeton
Génère un nouveau jeton d’identification de visiteur. Ce jeton sera unique chaque fois que ce point de terminaison est appelé, même s’il est appelé avec la même adresse e-mail. Ce jeton est temporaire et expire après 12 heures.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Messagerie électronique
|
string |
Adresse e-mail. |
||
|
Prénom
|
firstName | string |
Prénom. |
|
|
Nom de famille
|
lastName | string |
Nom. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Jeton
|
token | string |
Jeton. |
Mettre à jour un thread
Met à jour un thread unique. L’état d’un thread peut être mis à jour ou le thread peut être restauré.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Archivés
|
archived | boolean |
Indique s’il est archivé. |
|
|
Thread ID
|
threadId | True | string |
Identificateur de thread. |
|
Statut
|
status | string |
État. |
|
|
Archivés
|
archived | boolean |
Indique s’il est archivé. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de contact associé
|
associatedContactId | string |
Identificateur de contact associé. |
|
Créé à
|
createdAt | string |
Quand il est créé à l’adresse. |
|
ID
|
id | string |
Identificateur. |
|
ID de boîte de réception
|
inboxId | string |
Identificateur de la boîte de réception. |
|
Spam
|
spam | boolean |
Le courrier indésirable. |
|
Statut
|
status | string |
État. |
|
Fermé à
|
closedAt | string |
Quand il est fermé. |
|
Horodatage du message le plus récent
|
latestMessageTimestamp | string |
Horodatage du dernier message. |
|
Horodatage envoyé le plus récent du message
|
latestMessageSentTimestamp | string |
Le dernier message a envoyé un horodatage. |
|
Horodatage reçu le plus récent du message
|
latestMessageReceivedTimestamp | string |
Le dernier message a reçu l’horodatage. |
|
Affectation
|
assignedTo | string |
Auquel il est affecté. |
|
Archivés
|
archived | boolean |
Indique s’il est archivé. |
Obtenir des acteurs
Résolvez les identificateurs d’acteurs pour les acteurs et les participants sous-jacents.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propriété. |
|
|
Données d'entrée
|
inputs | array of string |
Entrées. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Terminé à
|
completedAt | string |
Une fois terminé. |
|
Results
|
results | array of object | |
|
ID
|
results.id | string |
Identificateur. |
|
Type
|
results.type | string |
Type. |
|
Nom
|
results.name | string |
Nom. |
|
Messagerie électronique
|
results.email | string |
Adresse e-mail. |
|
Avatar
|
results.avatar | string |
Avatar. |
|
Démarré à
|
startedAt | string |
Quand il a commencé à. |
|
Statut
|
status | string |
État. |
|
Demandé à
|
requestedAt | string |
Lorsqu’il est demandé à l’adresse. |
Obtenir des boîtes de réception de conversations
Récupérez une liste des boîtes de réception de conversations.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Après
|
after | string |
Lien Après. |
|
|
Limit
|
limit | string |
Limite de réponse. |
|
|
Trier
|
sort | string |
Ordre de tri. |
|
|
Longueur de page
|
defaultPageLength | string |
Longueur de page par défaut. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID
|
results.id | string |
Identificateur. |
|
Nom
|
results.name | string |
Nom. |
|
Créé à
|
results.createdAt | string |
Quand il est créé à l’adresse. |
|
Mise à jour à
|
results.updatedAt | string |
Lorsqu’il est mis à jour à l’adresse. |
|
Total
|
total | integer |
Total. |
|
Après
|
paging.next.after | string |
Lien Après. |
|
Lien
|
paging.next.link | string |
Lien. |
Obtenir des canaux
Récupérez une liste de canaux.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Après
|
after | string |
Lien Après. |
|
|
Limit
|
limit | string |
Limite de réponse. |
|
|
Trier
|
sort | string |
Ordre de tri. |
|
|
Longueur de page
|
defaultPageLength | string |
Longueur de page par défaut. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID
|
results.id | string |
Identificateur. |
|
Nom
|
results.name | string |
Nom. |
|
Total
|
total | integer |
Total. |
|
Après
|
paging.next.after | string |
Lien Après. |
|
Lien
|
paging.next.link | string |
Lien. |
Obtenir des comptes de canal
Récupérez une liste de comptes de canal.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de canal
|
channelId | string |
Identificateur de canal. |
|
|
ID de boîte de réception
|
inboxId | string |
Identificateur de la boîte de réception. |
|
|
Après
|
after | string |
Lien Après. |
|
|
Limit
|
limit | string |
Limite de réponse. |
|
|
Trier
|
sort | string |
Ordre de tri. |
|
|
Longueur de page
|
defaultPageLength | string |
Longueur de page par défaut. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID
|
results.id | string |
Identificateur. |
|
ID de canal
|
results.channelId | string |
Identificateur de canal. |
|
Nom
|
results.name | string |
Nom. |
|
ID de boîte de réception
|
results.inboxId | string |
Identificateur de la boîte de réception. |
|
Active
|
results.active | boolean |
Indique s’il est actif. |
|
Autorisé
|
results.authorized | boolean |
Indique si elle est autorisée. |
|
Créé à
|
results.createdAt | string |
Quand il est créé à l’adresse. |
|
Type
|
results.deliveryIdentifier.type | string |
Type. |
|
Valeur
|
results.deliveryIdentifier.value | string |
Valeur. |
|
Total
|
total | integer |
Total. |
|
Après
|
paging.next.after | string |
Lien Après. |
|
Lien
|
paging.next.link | string |
Lien. |
Obtenir des threads
Récupérez une liste de threads.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Après
|
after | string |
Lien Après. |
|
|
Limit
|
limit | string |
Limite de réponse. |
|
|
Trier
|
sort | string |
Ordre de tri. |
|
|
ID de boîte de réception
|
inboxId | string |
Identificateur de la boîte de réception. |
|
|
ID de contact associé
|
associatedContactId | string |
Identificateur de contact associé. |
|
|
État du thread
|
threadStatus | string |
État du thread. |
|
|
Horodatage le plus récent
|
latestMessageTimestampAfter | string |
Horodatage du message le plus récent après. |
|
|
Archivés
|
archived | boolean |
Indique s’il est archivé. |
|
|
property
|
property | string |
Propriété. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID de contact associé
|
results.associatedContactId | string |
Identificateur de contact associé. |
|
Créé à
|
results.createdAt | string |
Quand il est créé à l’adresse. |
|
ID
|
results.id | string |
Identificateur. |
|
ID de boîte de réception
|
results.inboxId | string |
Identificateur de la boîte de réception. |
|
Spam
|
results.spam | boolean |
Indique si le courrier indésirable. |
|
Statut
|
results.status | string |
État. |
|
Fermé à
|
results.closedAt | string |
Quand il est fermé. |
|
Horodatage du message le plus récent
|
results.latestMessageTimestamp | string |
Horodatage du dernier message. |
|
Horodatage envoyé le plus récent du message
|
results.latestMessageSentTimestamp | string |
Le dernier message a envoyé un horodatage. |
|
Horodatage reçu le plus récent du message
|
results.latestMessageReceivedTimestamp | string |
Le dernier message a reçu l’horodatage. |
|
Affectation
|
results.assignedTo | string |
Auquel il est affecté. |
|
Archivés
|
results.archived | boolean |
Indique s’il est archivé. |
|
Après
|
paging.next.after | string |
Lien Après. |
|
Lien
|
paging.next.link | string |
Lien. |
Obtenir le contenu d’origine d’un seul message
Retourne le texte d’origine complet et les corps de texte enrichi d’un message. Cela sera différent du texte et du texte enrichi dans le message lui-même si la troncationStatus du message n’est rien d’autre que NOT_TRUNCATED.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propriété. |
|
|
Thread ID
|
threadId | True | string |
Identificateur de thread. |
|
Message ID
|
messageId | True | string |
Identificateur du message. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Texto
|
text | string |
Texte. |
|
Format RTF (Rich Text Format)
|
richText | string |
Le texte rick. |
Obtenir l’historique des messages pour un thread
Récupérez la liste de l’historique des messages pour un thread.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Après
|
after | string |
Lien Après. |
|
|
Limit
|
limit | string |
Limite de réponse. |
|
|
Trier
|
sort | string |
Ordre de tri. |
|
|
Archivés
|
archived | boolean |
Indique s’il est archivé. |
|
|
property
|
property | string |
Propriété. |
|
|
Thread ID
|
threadId | True | string |
Identificateur de thread. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
Archivés
|
results.archived | boolean |
Indique s’il est archivé. |
|
Type de Client
|
results.client.clientType | string |
Type de client. |
|
ID d’application d’intégration
|
results.client.integrationAppId | string |
Identificateur de l’application d’intégration. |
|
Créé à
|
results.createdAt | string |
Quand il est créé à l’adresse. |
|
Créée par
|
results.createdBy | string |
Créé par. |
|
Direction
|
results.direction | string |
Direction. |
|
ID
|
results.id | string |
Identificateur. |
|
Destinataires
|
results.recipients | array of object | |
|
Type
|
results.recipients.deliveryIdentifier.type | string |
Type. |
|
Valeur
|
results.recipients.deliveryIdentifier.value | string |
Valeur. |
|
ID d’acteur
|
results.recipients.actorId | string |
Identificateur de l’acteur. |
|
Nom
|
results.recipients.name | string |
Nom. |
|
Champ destinataire
|
results.recipients.recipientField | string |
Champ destinataire. |
|
Expéditeurs
|
results.senders | array of object | |
|
ID d’acteur
|
results.senders.actorId | string |
Identificateur de l’acteur. |
|
Nom
|
results.senders.name | string |
Nom. |
|
Champ expéditeur
|
results.senders.senderField | string |
Champ expéditeur. |
|
Type
|
results.senders.deliveryIdentifier.type | string |
Type. |
|
Valeur
|
results.senders.deliveryIdentifier.value | string |
Valeur. |
|
Texto
|
results.text | string |
Texte. |
|
État de troncation
|
results.truncationStatus | string |
État de troncation. |
|
Type
|
results.type | string |
Type. |
|
Mise à jour à
|
results.updatedAt | string |
Lorsqu’il est mis à jour à l’adresse. |
|
Format RTF (Rich Text Format)
|
results.richText | string |
Texte enrichi. |
|
Sujet
|
results.subject | string |
Objet. |
|
Dans Répondre à l’ID
|
results.inReplyToId | string |
Réponse à l’identificateur. |
|
Type d’état
|
results.status.statusType | string |
Type d’état. |
|
Message d'erreur
|
results.status.failureDetails.errorMessage | string |
Message d’erreur. |
|
ID de canal
|
results.channelId | string |
Identificateur de canal. |
|
ID du compte de canal
|
results.channelAccountId | string |
Identificateur du compte de canal. |
|
ID du thread de conversation
|
results.conversationsThreadId | string |
Identificateur du thread de conversation. |
|
Après
|
paging.next.after | string |
Lien Après. |
|
Lien
|
paging.next.link | string |
Lien. |
Obtenir un compte de canal unique
Récupérez un compte de canal unique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du compte de canal
|
channelAccountId | True | string |
Identificateur du compte de canal. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificateur. |
|
ID de canal
|
channelId | string |
Identificateur de canal. |
|
Nom
|
name | string |
Nom. |
|
ID de boîte de réception
|
inboxId | string |
Identificateur de la boîte de réception. |
|
Active
|
active | boolean |
Indique s’il est actif. |
|
Autorisé
|
authorized | boolean |
Indique si elle est autorisée. |
|
Créé à
|
createdAt | string |
Quand il est créé à l’adresse. |
|
Type
|
deliveryIdentifier.type | string |
Type. |
|
Valeur
|
deliveryIdentifier.value | string |
Valeur. |
Obtenir un seul acteur
Récupérer un seul acteur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propriété. |
|
|
ID d’acteur
|
actorId | True | string |
Identificateur de l’acteur. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificateur. |
|
Type
|
type | string |
Type. |
|
Nom
|
name | string |
Nom. |
|
Messagerie électronique
|
string |
Adresse e-mail. |
|
|
Avatar
|
avatar | string |
Avatar. |
Obtenir un seul canal
Récupérez un seul canal.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de canal
|
channelId | True | string |
Identificateur de canal. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificateur. |
|
Nom
|
name | string |
Nom. |
Obtenir un seul message
Récupérez un message unique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propriété. |
|
|
Thread ID
|
threadId | True | string |
Identificateur de thread. |
|
Message ID
|
messageId | True | string |
Identificateur du message. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Valeur
|
value | string |
Valeur. |
Obtenir un thread unique
Récupère un thread unique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Archivés
|
archived | boolean |
Indique s’il est archivé. |
|
|
property
|
property | string |
Propriété. |
|
|
Thread ID
|
threadId | True | string |
Identificateur de thread. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de contact associé
|
associatedContactId | string |
Identificateur de contact associé. |
|
Créé à
|
createdAt | string |
Quand il est créé à l’adresse. |
|
ID
|
id | string |
Identificateur. |
|
ID de boîte de réception
|
inboxId | string |
Identificateur de la boîte de réception. |
|
Spam
|
spam | boolean |
Le courrier indésirable. |
|
Statut
|
status | string |
État. |
|
Fermé à
|
closedAt | string |
Quand il est fermé. |
|
Horodatage du message le plus récent
|
latestMessageTimestamp | string |
Horodatage du dernier message. |
|
Horodatage envoyé le plus récent du message
|
latestMessageSentTimestamp | string |
Le dernier message a envoyé un horodatage. |
|
Horodatage reçu le plus récent du message
|
latestMessageReceivedTimestamp | string |
Le dernier message a reçu l’horodatage. |
|
Affectation
|
assignedTo | string |
Auquel il est affecté. |
|
Archivés
|
archived | boolean |
Indique s’il est archivé. |
Obtenir une boîte de réception de conversations unique
Récupérer une boîte de réception de conversations unique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de boîte de réception
|
inboxId | True | string |
Identificateur de la boîte de réception. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificateur. |
|
Nom
|
name | string |
Nom. |
|
Créé à
|
createdAt | string |
Quand il est créé à l’adresse. |
|
Mise à jour à
|
updatedAt | string |
Lorsqu’il est mis à jour à l’adresse. |
Définitions
ficelle
Il s’agit du type de données de base « string ».