Freigeben über


HubSpot-Unterhaltungen V2 (unabhängiger Herausgeber) (Vorschau)

Mit den HubSpot-Unterhaltungsdiensten können Sie die Unterhaltungen in Posteingang, Kanälen und Nachrichten verwalten und mit ihnen interagieren.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connectormetadaten
Herausgeber Troy Taylor
Webseite https://www.hubspot.com/products/crm/conversations
Datenschutzrichtlinie https://legal.hubspot.com/privacy-policy
Kategorien Marketing; Vertrieb und CRM

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
Zugriffstoken (im Format "Bearer YOUR_ACCESS_TOKEN") securestring Das Zugriffstoken (im Format "Bearer YOUR_ACCESS_TOKEN") für diese API Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen des Nachrichtenverlaufs für einen Thread

Dient zum Abrufen einer Liste des Nachrichtenverlaufs für einen Thread.

Abrufen des ursprünglichen Inhalts einer einzelnen Nachricht

Gibt den vollständigen Originaltext und Rich-Text-Textkörper einer Nachricht zurück. Dies unterscheidet sich vom Text und Rich-Text in der Nachricht selbst, wenn der Abschneidenstatus der Nachricht etwas anderes als NOT_TRUNCATED ist.

Abrufen einer einzelnen Nachricht

Rufen Sie eine einzelne Nachricht ab.

Abrufen eines einzelnen Akteurs

Abrufen eines einzelnen Akteurs.

Abrufen eines einzelnen Kanalkontos

Rufen Sie ein einzelnes Kanalkonto ab.

Abrufen eines einzelnen Kanals

Rufen Sie einen einzelnen Kanal ab.

Abrufen eines einzelnen Posteingangs für Unterhaltungen

Abrufen eines einzelnen Unterhaltungs-Posteingangs.

Abrufen eines einzelnen Threads

Ruft einen einzelnen Thread ab.

Abrufen von Kanalkonten

Dient zum Abrufen einer Liste von Kanalkonten.

Abrufen von Schauspielern

Lösen Sie Akteure-IDs für die zugrunde liegenden Akteure und Teilnehmer auf.

Abrufen von Threads

Dient zum Abrufen einer Liste von Threads.

Abrufen von Unterhaltungen in Posteingängen

Dient zum Abrufen einer Liste von Unterhaltungs-Posteingängen.

Aktualisieren eines Threads

Aktualisiert einen einzelnen Thread. Entweder kann der Status eines Threads aktualisiert werden, oder der Thread kann wiederhergestellt werden.

Archiviert einen Thread

Archiviert einen einzelnen Thread. Der Thread wird 30 Tage nach dem Einfügen in einen archivierten Zustand endgültig gelöscht.

Ein Token generieren

Generiert ein neues Besucheridentifikationstoken. Dieses Token wird jedes Mal eindeutig, wenn dieser Endpunkt aufgerufen wird, auch wenn es mit derselben E-Mail-Adresse aufgerufen wird. Dieses Token ist temporär und läuft nach 12 Stunden ab.

Kanäle abrufen

Dient zum Abrufen einer Liste von Kanälen.

Senden einer Nachricht an einen Thread

Senden Einer neuen Nachricht in einem Thread zum aktuellen Zeitstempel.

Abrufen des Nachrichtenverlaufs für einen Thread

Dient zum Abrufen einer Liste des Nachrichtenverlaufs für einen Thread.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Nach
after string

Der Link "Nach".

Limit
limit string

Der Antwortgrenzwert.

Sortieren
sort string

Die Sortierreihenfolge.

Archived
archived boolean

Gibt an, ob archiviert.

property
property string

Die Eigenschaft.

Thread-ID
threadId True string

Der Threadbezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
Ergebnisse
results array of object
Archived
results.archived boolean

Gibt an, ob archiviert.

Clienttyp
results.client.clientType string

Der Clienttyp.

Integrations-App-ID
results.client.integrationAppId string

Der Integrations-App-Bezeichner.

Erstellt unter
results.createdAt string

Beim Erstellen bei.

Erstellt von
results.createdBy string

Das erstellt von.

Richtung
results.direction string

Die Richtung.

ID
results.id string

Der Bezeichner.

Empfänger
results.recipients array of object
Typ
results.recipients.deliveryIdentifier.type string

Der Typ.

Wert
results.recipients.deliveryIdentifier.value string

Der Wert.

Akteur-ID
results.recipients.actorId string

Der Akteurbezeichner.

Name
results.recipients.name string

Der Name.

Empfängerfeld
results.recipients.recipientField string

Das Empfängerfeld.

Absender
results.senders array of object
Akteur-ID
results.senders.actorId string

Der Akteurbezeichner.

Name
results.senders.name string

Der Name.

Absenderfeld
results.senders.senderField string

Das Absenderfeld.

Typ
results.senders.deliveryIdentifier.type string

Der Typ.

Wert
results.senders.deliveryIdentifier.value string

Der Wert.

Text
results.text string

Der Text.

Abschneiden des Status
results.truncationStatus string

Der Abkürzungsstatus.

Typ
results.type string

Der Typ.

Aktualisiert unter
results.updatedAt string

Wenn aktualisiert unter.

Rich-Text
results.richText string

Der Rich-Text.

Betreff
results.subject string

Der Betreff.

In Antwort auf ID
results.inReplyToId string

Die Antwort auf den Bezeichner.

Statustyp
results.status.statusType string

Der Statustyp.

Fehlermeldung
results.status.failureDetails.errorMessage string

Die Fehlermeldung.

Kanal-ID
results.channelId string

Der Kanalbezeichner.

Kanalkonto-ID
results.channelAccountId string

Der Kanalkontobezeichner.

Unterhaltungsthread-ID
results.conversationsThreadId string

Der Unterhaltungsthreadbezeichner.

Nach
paging.next.after string

Der Link "Nach".

Link
paging.next.link string

Der Link.

Abrufen des ursprünglichen Inhalts einer einzelnen Nachricht

Gibt den vollständigen Originaltext und Rich-Text-Textkörper einer Nachricht zurück. Dies unterscheidet sich vom Text und Rich-Text in der Nachricht selbst, wenn der Abschneidenstatus der Nachricht etwas anderes als NOT_TRUNCATED ist.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
property
property string

Die Eigenschaft.

Thread-ID
threadId True string

Der Threadbezeichner.

Nachrichten-ID
messageId True string

Der Nachrichtenbezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
Text
text string

Der Text.

Rich-Text
richText string

Der Rick-Text.

Abrufen einer einzelnen Nachricht

Rufen Sie eine einzelne Nachricht ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
property
property string

Die Eigenschaft.

Thread-ID
threadId True string

Der Threadbezeichner.

Nachrichten-ID
messageId True string

Der Nachrichtenbezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
Wert
value string

Der Wert.

Abrufen eines einzelnen Akteurs

Abrufen eines einzelnen Akteurs.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
property
property string

Die Eigenschaft.

Akteur-ID
actorId True string

Der Akteurbezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
ID
id string

Der Bezeichner.

Typ
type string

Der Typ.

Name
name string

Der Name.

Email
email string

Die E-Mail-Adresse.

Avatar
avatar string

Der Avatar.

Abrufen eines einzelnen Kanalkontos

Rufen Sie ein einzelnes Kanalkonto ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kanalkonto-ID
channelAccountId True string

Der Kanalkontobezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
ID
id string

Der Bezeichner.

Kanal-ID
channelId string

Der Kanalbezeichner.

Name
name string

Der Name.

Posteingangs-ID
inboxId string

Der Posteingangsbezeichner.

Active
active boolean

Gibt an, ob aktiv.

Befugt
authorized boolean

Ob autorisiert.

Erstellt unter
createdAt string

Beim Erstellen bei.

Typ
deliveryIdentifier.type string

Der Typ.

Wert
deliveryIdentifier.value string

Der Wert.

Abrufen eines einzelnen Kanals

Rufen Sie einen einzelnen Kanal ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kanal-ID
channelId True string

Der Kanalbezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
ID
id string

Der Bezeichner.

Name
name string

Der Name.

Abrufen eines einzelnen Posteingangs für Unterhaltungen

Abrufen eines einzelnen Unterhaltungs-Posteingangs.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Posteingangs-ID
inboxId True string

Der Posteingangsbezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
ID
id string

Der Bezeichner.

Name
name string

Der Name.

Erstellt unter
createdAt string

Beim Erstellen bei.

Aktualisiert unter
updatedAt string

Wenn aktualisiert unter.

Abrufen eines einzelnen Threads

Ruft einen einzelnen Thread ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Archived
archived boolean

Gibt an, ob archiviert.

property
property string

Die Eigenschaft.

Thread-ID
threadId True string

Der Threadbezeichner.

Gibt zurück

Name Pfad Typ Beschreibung
Zugeordnete Kontakt-ID
associatedContactId string

Der zugeordnete Kontaktbezeichner.

Erstellt unter
createdAt string

Beim Erstellen bei.

ID
id string

Der Bezeichner.

Posteingangs-ID
inboxId string

Der Posteingangsbezeichner.

Spam-Nachricht
spam boolean

Der Spam.

Der Status
status string

Der Status.

Geschlossen am
closedAt string

Wenn geschlossen bei.

Neuester Nachrichtenzeitstempel
latestMessageTimestamp string

Der neueste Nachrichtenzeitstempel.

Neueste Nachricht gesendeter Zeitstempel
latestMessageSentTimestamp string

Die neueste Nachricht, die Zeitstempel gesendet hat.

Letzter Zeitstempel der empfangenen Nachricht
latestMessageReceivedTimestamp string

Der neueste Empfangene Zeitstempel der Nachricht.

Zugeordnet
assignedTo string

Das zugewiesene.

Archived
archived boolean

Gibt an, ob archiviert.

Abrufen von Kanalkonten

Dient zum Abrufen einer Liste von Kanalkonten.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kanal-ID
channelId string

Der Kanalbezeichner.

Posteingangs-ID
inboxId string

Der Posteingangsbezeichner.

Nach
after string

Der Link "Nach".

Limit
limit string

Der Antwortgrenzwert.

Sortieren
sort string

Die Sortierreihenfolge.

Seitenlänge
defaultPageLength string

Die Standardseitenlänge.

Gibt zurück

Name Pfad Typ Beschreibung
Ergebnisse
results array of object
ID
results.id string

Der Bezeichner.

Kanal-ID
results.channelId string

Der Kanalbezeichner.

Name
results.name string

Der Name.

Posteingangs-ID
results.inboxId string

Der Posteingangsbezeichner.

Active
results.active boolean

Gibt an, ob aktiv.

Befugt
results.authorized boolean

Ob autorisiert.

Erstellt unter
results.createdAt string

Beim Erstellen bei.

Typ
results.deliveryIdentifier.type string

Der Typ.

Wert
results.deliveryIdentifier.value string

Der Wert.

Total
total integer

Die Summe.

Nach
paging.next.after string

Der Link "Nach".

Link
paging.next.link string

Der Link.

Abrufen von Schauspielern

Lösen Sie Akteure-IDs für die zugrunde liegenden Akteure und Teilnehmer auf.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
property
property string

Die Eigenschaft.

Eingänge
inputs array of string

Die Eingaben.

Gibt zurück

Name Pfad Typ Beschreibung
Abgeschlossen bei
completedAt string

Nach Abschluss bei.

Ergebnisse
results array of object
ID
results.id string

Der Bezeichner.

Typ
results.type string

Der Typ.

Name
results.name string

Der Name.

Email
results.email string

Die E-Mail-Adresse.

Avatar
results.avatar string

Der Avatar.

Begonnen am
startedAt string

Wann beginnen sie bei.

Der Status
status string

Der Status.

Angefordert bei
requestedAt string

Bei Bedarf bei.

Abrufen von Threads

Dient zum Abrufen einer Liste von Threads.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Nach
after string

Der Link "Nach".

Limit
limit string

Der Antwortgrenzwert.

Sortieren
sort string

Die Sortierreihenfolge.

Posteingangs-ID
inboxId string

Der Posteingangsbezeichner.

Zugeordnete Kontakt-ID
associatedContactId string

Der zugeordnete Kontaktbezeichner.

Threadstatus
threadStatus string

Der Threadstatus.

Neuester Zeitstempel
latestMessageTimestampAfter string

Der aktuelle Zeitstempel der Nachricht.

Archived
archived boolean

Gibt an, ob archiviert.

property
property string

Die Eigenschaft.

Gibt zurück

Name Pfad Typ Beschreibung
Ergebnisse
results array of object
Zugeordnete Kontakt-ID
results.associatedContactId string

Der zugeordnete Kontaktbezeichner.

Erstellt unter
results.createdAt string

Beim Erstellen bei.

ID
results.id string

Der Bezeichner.

Posteingangs-ID
results.inboxId string

Der Posteingangsbezeichner.

Spam-Nachricht
results.spam boolean

Gibt an, ob Spam.

Der Status
results.status string

Der Status.

Geschlossen am
results.closedAt string

Wenn geschlossen bei.

Neuester Nachrichtenzeitstempel
results.latestMessageTimestamp string

Der neueste Nachrichtenzeitstempel.

Neueste Nachricht gesendeter Zeitstempel
results.latestMessageSentTimestamp string

Die neueste Nachricht, die Zeitstempel gesendet hat.

Letzter Zeitstempel der empfangenen Nachricht
results.latestMessageReceivedTimestamp string

Der neueste Empfangene Zeitstempel der Nachricht.

Zugeordnet
results.assignedTo string

Das zugewiesene.

Archived
results.archived boolean

Gibt an, ob archiviert.

Nach
paging.next.after string

Der Link "Nach".

Link
paging.next.link string

Der Link.

Abrufen von Unterhaltungen in Posteingängen

Dient zum Abrufen einer Liste von Unterhaltungs-Posteingängen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Nach
after string

Der Link "Nach".

Limit
limit string

Der Antwortgrenzwert.

Sortieren
sort string

Die Sortierreihenfolge.

Seitenlänge
defaultPageLength string

Die Standardseitenlänge.

Gibt zurück

Name Pfad Typ Beschreibung
Ergebnisse
results array of object
ID
results.id string

Der Bezeichner.

Name
results.name string

Der Name.

Erstellt unter
results.createdAt string

Beim Erstellen bei.

Aktualisiert unter
results.updatedAt string

Wenn aktualisiert unter.

Total
total integer

Die Summe.

Nach
paging.next.after string

Der Link "Nach".

Link
paging.next.link string

Der Link.

Aktualisieren eines Threads

Aktualisiert einen einzelnen Thread. Entweder kann der Status eines Threads aktualisiert werden, oder der Thread kann wiederhergestellt werden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Archived
archived boolean

Gibt an, ob archiviert.

Thread-ID
threadId True string

Der Threadbezeichner.

Der Status
status string

Der Status.

Archived
archived boolean

Gibt an, ob archiviert.

Gibt zurück

Name Pfad Typ Beschreibung
Zugeordnete Kontakt-ID
associatedContactId string

Der zugeordnete Kontaktbezeichner.

Erstellt unter
createdAt string

Beim Erstellen bei.

ID
id string

Der Bezeichner.

Posteingangs-ID
inboxId string

Der Posteingangsbezeichner.

Spam-Nachricht
spam boolean

Der Spam.

Der Status
status string

Der Status.

Geschlossen am
closedAt string

Wenn geschlossen bei.

Neuester Nachrichtenzeitstempel
latestMessageTimestamp string

Der neueste Nachrichtenzeitstempel.

Neueste Nachricht gesendeter Zeitstempel
latestMessageSentTimestamp string

Die neueste Nachricht, die Zeitstempel gesendet hat.

Letzter Zeitstempel der empfangenen Nachricht
latestMessageReceivedTimestamp string

Der neueste Empfangene Zeitstempel der Nachricht.

Zugeordnet
assignedTo string

Das zugewiesene.

Archived
archived boolean

Gibt an, ob archiviert.

Archiviert einen Thread

Archiviert einen einzelnen Thread. Der Thread wird 30 Tage nach dem Einfügen in einen archivierten Zustand endgültig gelöscht.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Thread-ID
threadId True string

Der Threadbezeichner.

Gibt zurück

response
string

Ein Token generieren

Generiert ein neues Besucheridentifikationstoken. Dieses Token wird jedes Mal eindeutig, wenn dieser Endpunkt aufgerufen wird, auch wenn es mit derselben E-Mail-Adresse aufgerufen wird. Dieses Token ist temporär und läuft nach 12 Stunden ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Email
email string

Die E-Mail-Adresse.

Vorname
firstName string

Der Vorname.

Nachname
lastName string

Der Nachname.

Gibt zurück

Name Pfad Typ Beschreibung
Token
token string

Das Token.

Kanäle abrufen

Dient zum Abrufen einer Liste von Kanälen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Nach
after string

Der Link "Nach".

Limit
limit string

Der Antwortgrenzwert.

Sortieren
sort string

Die Sortierreihenfolge.

Seitenlänge
defaultPageLength string

Die Standardseitenlänge.

Gibt zurück

Name Pfad Typ Beschreibung
Ergebnisse
results array of object
ID
results.id string

Der Bezeichner.

Name
results.name string

Der Name.

Total
total integer

Die Summe.

Nach
paging.next.after string

Der Link "Nach".

Link
paging.next.link string

Der Link.

Senden einer Nachricht an einen Thread

Senden Einer neuen Nachricht in einem Thread zum aktuellen Zeitstempel.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Thread-ID
threadId True string

Der Threadbezeichner.

Attachments
attachments array of

Das Attachments-Objekt.

Kanalkonto-ID
channelAccountId string

Der Kanalkontobezeichner.

Kanal-ID
channelId string

Der Kanalbezeichner.

Typ
type string

Der Typ.

Wert
value string

Der Wert.

Akteur-ID
actorId string

Der Akteurbezeichner.

Name
name string

Der Name.

Empfängerfeld
recipientField string

Das Empfängerfeld.

Typ
type string

Der Typ.

Wert
value string

Der Wert.

Sender Actor ID
senderActorId string

Der Absender-Akteurbezeichner.

Text
text string

Der Text.

Typ
type string

Der Typ.

Rich-Text
richText string

Der Rick-Text.

Betreff
subject string

Der Betreff.

Gibt zurück

response
string

Definitionen

Schnur

Dies ist der grundlegende Datentyp "string".