HubSpot Conversations V2 (Onafhankelijke uitgever) (preview)
Met de HubSpot-gesprekkenservices kunt u het Postvak IN van gesprekken, kanalen en berichten beheren en ermee werken.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| E-mailen | ttaylor@hitachisolutions.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Troy Taylor |
| Webpagina | https://www.hubspot.com/products/crm/conversations |
| Privacybeleid | https://legal.hubspot.com/privacy-policy |
| Categorieën | Marketing; Verkoop en CRM |
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Toegangstoken (in de vorm Bearer YOUR_ACCESS_TOKEN) | beveiligde string | Het toegangstoken (in de vorm 'Bearer YOUR_ACCESS_TOKEN') voor deze API | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Acteurs ophalen |
Los actoren-id's op voor de onderliggende actoren en deelnemers. |
| Berichtgeschiedenis voor een thread ophalen |
Haal een lijst met berichtgeschiedenis voor een thread op. |
| De oorspronkelijke inhoud van één bericht ophalen |
Retourneert de volledige oorspronkelijke tekst en teksttekst met opmaak van een bericht. Dit verschilt van de tekst en tekst met opmaak in het bericht zelf als de afkappingStatus van het bericht iets anders is dan NOT_TRUNCATED. |
| Een bericht verzenden naar een thread |
Verzend een nieuw bericht op een thread in de huidige tijdstempel. |
| Een thread archiveren |
Archiveert één thread. De thread wordt 30 dagen na het plaatsen in een gearchiveerde status definitief verwijderd. |
| Een thread bijwerken |
Hiermee wordt één thread bijgewerkt. De status van een thread kan worden bijgewerkt of de thread kan worden hersteld. |
| Een token genereren |
Hiermee wordt een nieuw bezoekersidentificatietoken gegenereerd. Dit token is uniek telkens wanneer dit eindpunt wordt aangeroepen, zelfs als dit met hetzelfde e-mailadres wordt aangeroepen. Dit token is tijdelijk en verloopt na 12 uur. |
| Eén actor ophalen |
Eén actor ophalen. |
| Eén bericht ophalen |
Eén bericht ophalen. |
| Eén kanaal ophalen |
Eén kanaal ophalen. |
| Eén kanaalaccount ophalen |
Eén kanaalaccount ophalen. |
| Eén Postvak IN van gesprekken ophalen |
Eén postvak IN voor gesprekken ophalen. |
| Eén thread ophalen |
Hiermee haalt u één thread op. |
| Kanaalaccounts ophalen |
Een lijst met kanaalaccounts ophalen. |
| Kanalen ophalen |
Haal een lijst met kanalen op. |
| Postvakken voor gesprekken ophalen |
Haal een lijst met gesprekken in postvakken op. |
| Threads ophalen |
Een lijst met threads ophalen. |
Acteurs ophalen
Los actoren-id's op voor de onderliggende actoren en deelnemers.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
vastgoed
|
property | string |
De eigenschap. |
|
|
Invoer
|
inputs | array of string |
De invoer. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Voltooid op
|
completedAt | string |
Wanneer voltooid op. |
|
Results
|
results | array of object | |
|
ID-kaart
|
results.id | string |
De id. |
|
Typologie
|
results.type | string |
Het type. |
|
Naam
|
results.name | string |
De naam. |
|
E-mailen
|
results.email | string |
Het e-mailadres. |
|
Avatar
|
results.avatar | string |
De avatar. |
|
Gestart bij
|
startedAt | string |
Toen begon het. |
|
Toestand
|
status | string |
De status. |
|
Aangevraagd op
|
requestedAt | string |
Wanneer u hierom wordt gevraagd. |
Berichtgeschiedenis voor een thread ophalen
Haal een lijst met berichtgeschiedenis voor een thread op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Na
|
after | string |
De koppeling Na. |
|
|
Limit
|
limit | string |
De antwoordlimiet. |
|
|
Sorteren
|
sort | string |
De sorteervolgorde. |
|
|
Gearchiveerde
|
archived | boolean |
Of het nu gearchiveerd is. |
|
|
vastgoed
|
property | string |
De eigenschap. |
|
|
Thread-id
|
threadId | True | string |
De thread-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
Gearchiveerde
|
results.archived | boolean |
Of het nu gearchiveerd is. |
|
Clienttype
|
results.client.clientType | string |
Het clienttype. |
|
Id van integratie-app
|
results.client.integrationAppId | string |
De id van de integratie-app. |
|
Gemaakt op
|
results.createdAt | string |
Wanneer gemaakt op. |
|
Gemaakt door
|
results.createdBy | string |
De gemaakt door. |
|
Richting
|
results.direction | string |
De richting. |
|
ID-kaart
|
results.id | string |
De id. |
|
Ontvangers
|
results.recipients | array of object | |
|
Typologie
|
results.recipients.deliveryIdentifier.type | string |
Het type. |
|
Waarde
|
results.recipients.deliveryIdentifier.value | string |
De waarde. |
|
Actor-id
|
results.recipients.actorId | string |
De actor-id. |
|
Naam
|
results.recipients.name | string |
De naam. |
|
Veld geadresseerde
|
results.recipients.recipientField | string |
Het veld geadresseerde. |
|
Afzenders
|
results.senders | array of object | |
|
Actor-id
|
results.senders.actorId | string |
De actor-id. |
|
Naam
|
results.senders.name | string |
De naam. |
|
Veld Afzender
|
results.senders.senderField | string |
Het veld Afzender. |
|
Typologie
|
results.senders.deliveryIdentifier.type | string |
Het type. |
|
Waarde
|
results.senders.deliveryIdentifier.value | string |
De waarde. |
|
Tekst
|
results.text | string |
De tekst. |
|
Afkappingsstatus
|
results.truncationStatus | string |
De afkappingsstatus. |
|
Typologie
|
results.type | string |
Het type. |
|
Bijgewerkt op
|
results.updatedAt | string |
Wanneer bijgewerkt op. |
|
Rtf
|
results.richText | string |
De rtf-tekst. |
|
Onderwerp
|
results.subject | string |
Het onderwerp. |
|
In Antwoord-id
|
results.inReplyToId | string |
De antwoord-id. |
|
Statustype
|
results.status.statusType | string |
Het statustype. |
|
Foutmelding
|
results.status.failureDetails.errorMessage | string |
Het foutbericht. |
|
Kanaal-id
|
results.channelId | string |
De kanaal-id. |
|
Kanaalaccount-id
|
results.channelAccountId | string |
De kanaalaccount-id. |
|
Gespreksthread-id
|
results.conversationsThreadId | string |
De gespreksthread-id. |
|
Na
|
paging.next.after | string |
De koppeling Na. |
|
Link
|
paging.next.link | string |
De koppeling. |
De oorspronkelijke inhoud van één bericht ophalen
Retourneert de volledige oorspronkelijke tekst en teksttekst met opmaak van een bericht. Dit verschilt van de tekst en tekst met opmaak in het bericht zelf als de afkappingStatus van het bericht iets anders is dan NOT_TRUNCATED.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
vastgoed
|
property | string |
De eigenschap. |
|
|
Thread-id
|
threadId | True | string |
De thread-id. |
|
Bericht-id
|
messageId | True | string |
De bericht-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Tekst
|
text | string |
De tekst. |
|
Rtf
|
richText | string |
De ricktekst. |
Een bericht verzenden naar een thread
Verzend een nieuw bericht op een thread in de huidige tijdstempel.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Thread-id
|
threadId | True | string |
De thread-id. |
|
Bijlagen
|
attachments | array of |
Het bijlageobject. |
|
|
Kanaalaccount-id
|
channelAccountId | string |
De kanaalaccount-id. |
|
|
Kanaal-id
|
channelId | string |
De kanaal-id. |
|
|
Typologie
|
type | string |
Het type. |
|
|
Waarde
|
value | string |
De waarde. |
|
|
Actor-id
|
actorId | string |
De actor-id. |
|
|
Naam
|
name | string |
De naam. |
|
|
Veld geadresseerde
|
recipientField | string |
Het veld geadresseerde. |
|
|
Typologie
|
type | string |
Het type. |
|
|
Waarde
|
value | string |
De waarde. |
|
|
Actor-id van afzender
|
senderActorId | string |
De actor-id van de afzender. |
|
|
Tekst
|
text | string |
De tekst. |
|
|
Typologie
|
type | string |
Het type. |
|
|
Rtf
|
richText | string |
De ricktekst. |
|
|
Onderwerp
|
subject | string |
Het onderwerp. |
Retouren
- response
- string
Een thread archiveren
Archiveert één thread. De thread wordt 30 dagen na het plaatsen in een gearchiveerde status definitief verwijderd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Thread-id
|
threadId | True | string |
De thread-id. |
Retouren
- response
- string
Een thread bijwerken
Hiermee wordt één thread bijgewerkt. De status van een thread kan worden bijgewerkt of de thread kan worden hersteld.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gearchiveerde
|
archived | boolean |
Of het nu gearchiveerd is. |
|
|
Thread-id
|
threadId | True | string |
De thread-id. |
|
Toestand
|
status | string |
De status. |
|
|
Gearchiveerde
|
archived | boolean |
Of het nu gearchiveerd is. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gekoppelde contactpersoon-id
|
associatedContactId | string |
De bijbehorende contactpersoon-id. |
|
Gemaakt op
|
createdAt | string |
Wanneer gemaakt op. |
|
ID-kaart
|
id | string |
De id. |
|
Postvak IN-id
|
inboxId | string |
De Postvak IN-id. |
|
Spam
|
spam | boolean |
De spam. |
|
Toestand
|
status | string |
De status. |
|
Gesloten om
|
closedAt | string |
Als het gesloten is. |
|
Laatste tijdstempel van bericht
|
latestMessageTimestamp | string |
De laatste tijdstempel van het bericht. |
|
Laatste bericht verzonden tijdstempel
|
latestMessageSentTimestamp | string |
Het meest recente bericht dat een tijdstempel heeft verzonden. |
|
Laatste bericht ontvangen tijdstempel
|
latestMessageReceivedTimestamp | string |
Het laatste bericht heeft een tijdstempel ontvangen. |
|
Assigned To
|
assignedTo | string |
De toegewezen aan. |
|
Gearchiveerde
|
archived | boolean |
Of het nu gearchiveerd is. |
Een token genereren
Hiermee wordt een nieuw bezoekersidentificatietoken gegenereerd. Dit token is uniek telkens wanneer dit eindpunt wordt aangeroepen, zelfs als dit met hetzelfde e-mailadres wordt aangeroepen. Dit token is tijdelijk en verloopt na 12 uur.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
E-mailen
|
string |
Het e-mailadres. |
||
|
Voornaam
|
firstName | string |
De voornaam. |
|
|
Achternaam
|
lastName | string |
De achternaam. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Teken
|
token | string |
Het token. |
Eén actor ophalen
Eén actor ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
vastgoed
|
property | string |
De eigenschap. |
|
|
Actor-id
|
actorId | True | string |
De actor-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | string |
De id. |
|
Typologie
|
type | string |
Het type. |
|
Naam
|
name | string |
De naam. |
|
E-mailen
|
string |
Het e-mailadres. |
|
|
Avatar
|
avatar | string |
De avatar. |
Eén bericht ophalen
Eén bericht ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
vastgoed
|
property | string |
De eigenschap. |
|
|
Thread-id
|
threadId | True | string |
De thread-id. |
|
Bericht-id
|
messageId | True | string |
De bericht-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Waarde
|
value | string |
De waarde. |
Eén kanaal ophalen
Eén kanaal ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Kanaal-id
|
channelId | True | string |
De kanaal-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | string |
De id. |
|
Naam
|
name | string |
De naam. |
Eén kanaalaccount ophalen
Eén kanaalaccount ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Kanaalaccount-id
|
channelAccountId | True | string |
De kanaalaccount-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | string |
De id. |
|
Kanaal-id
|
channelId | string |
De kanaal-id. |
|
Naam
|
name | string |
De naam. |
|
Postvak IN-id
|
inboxId | string |
De Postvak IN-id. |
|
Active
|
active | boolean |
Of het nu actief is. |
|
Geautoriseerd
|
authorized | boolean |
Of dit is toegestaan. |
|
Gemaakt op
|
createdAt | string |
Wanneer gemaakt op. |
|
Typologie
|
deliveryIdentifier.type | string |
Het type. |
|
Waarde
|
deliveryIdentifier.value | string |
De waarde. |
Eén Postvak IN van gesprekken ophalen
Eén postvak IN voor gesprekken ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Postvak IN-id
|
inboxId | True | string |
De Postvak IN-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
ID-kaart
|
id | string |
De id. |
|
Naam
|
name | string |
De naam. |
|
Gemaakt op
|
createdAt | string |
Wanneer gemaakt op. |
|
Bijgewerkt op
|
updatedAt | string |
Wanneer bijgewerkt op. |
Eén thread ophalen
Hiermee haalt u één thread op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gearchiveerde
|
archived | boolean |
Of het nu gearchiveerd is. |
|
|
vastgoed
|
property | string |
De eigenschap. |
|
|
Thread-id
|
threadId | True | string |
De thread-id. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gekoppelde contactpersoon-id
|
associatedContactId | string |
De bijbehorende contactpersoon-id. |
|
Gemaakt op
|
createdAt | string |
Wanneer gemaakt op. |
|
ID-kaart
|
id | string |
De id. |
|
Postvak IN-id
|
inboxId | string |
De Postvak IN-id. |
|
Spam
|
spam | boolean |
De spam. |
|
Toestand
|
status | string |
De status. |
|
Gesloten om
|
closedAt | string |
Als het gesloten is. |
|
Laatste tijdstempel van bericht
|
latestMessageTimestamp | string |
De laatste tijdstempel van het bericht. |
|
Laatste bericht verzonden tijdstempel
|
latestMessageSentTimestamp | string |
Het meest recente bericht dat een tijdstempel heeft verzonden. |
|
Laatste bericht ontvangen tijdstempel
|
latestMessageReceivedTimestamp | string |
Het laatste bericht heeft een tijdstempel ontvangen. |
|
Assigned To
|
assignedTo | string |
De toegewezen aan. |
|
Gearchiveerde
|
archived | boolean |
Of het nu gearchiveerd is. |
Kanaalaccounts ophalen
Een lijst met kanaalaccounts ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Kanaal-id
|
channelId | string |
De kanaal-id. |
|
|
Postvak IN-id
|
inboxId | string |
De Postvak IN-id. |
|
|
Na
|
after | string |
De koppeling Na. |
|
|
Limit
|
limit | string |
De antwoordlimiet. |
|
|
Sorteren
|
sort | string |
De sorteervolgorde. |
|
|
Paginalengte
|
defaultPageLength | string |
De standaardpaginalengte. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID-kaart
|
results.id | string |
De id. |
|
Kanaal-id
|
results.channelId | string |
De kanaal-id. |
|
Naam
|
results.name | string |
De naam. |
|
Postvak IN-id
|
results.inboxId | string |
De Postvak IN-id. |
|
Active
|
results.active | boolean |
Of het nu actief is. |
|
Geautoriseerd
|
results.authorized | boolean |
Of dit is toegestaan. |
|
Gemaakt op
|
results.createdAt | string |
Wanneer gemaakt op. |
|
Typologie
|
results.deliveryIdentifier.type | string |
Het type. |
|
Waarde
|
results.deliveryIdentifier.value | string |
De waarde. |
|
Total
|
total | integer |
Het totaal. |
|
Na
|
paging.next.after | string |
De koppeling Na. |
|
Link
|
paging.next.link | string |
De koppeling. |
Kanalen ophalen
Haal een lijst met kanalen op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Na
|
after | string |
De koppeling Na. |
|
|
Limit
|
limit | string |
De antwoordlimiet. |
|
|
Sorteren
|
sort | string |
De sorteervolgorde. |
|
|
Paginalengte
|
defaultPageLength | string |
De standaardpaginalengte. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID-kaart
|
results.id | string |
De id. |
|
Naam
|
results.name | string |
De naam. |
|
Total
|
total | integer |
Het totaal. |
|
Na
|
paging.next.after | string |
De koppeling Na. |
|
Link
|
paging.next.link | string |
De koppeling. |
Postvakken voor gesprekken ophalen
Haal een lijst met gesprekken in postvakken op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Na
|
after | string |
De koppeling Na. |
|
|
Limit
|
limit | string |
De antwoordlimiet. |
|
|
Sorteren
|
sort | string |
De sorteervolgorde. |
|
|
Paginalengte
|
defaultPageLength | string |
De standaardpaginalengte. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
ID-kaart
|
results.id | string |
De id. |
|
Naam
|
results.name | string |
De naam. |
|
Gemaakt op
|
results.createdAt | string |
Wanneer gemaakt op. |
|
Bijgewerkt op
|
results.updatedAt | string |
Wanneer bijgewerkt op. |
|
Total
|
total | integer |
Het totaal. |
|
Na
|
paging.next.after | string |
De koppeling Na. |
|
Link
|
paging.next.link | string |
De koppeling. |
Threads ophalen
Een lijst met threads ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Na
|
after | string |
De koppeling Na. |
|
|
Limit
|
limit | string |
De antwoordlimiet. |
|
|
Sorteren
|
sort | string |
De sorteervolgorde. |
|
|
Postvak IN-id
|
inboxId | string |
De Postvak IN-id. |
|
|
Gekoppelde contactpersoon-id
|
associatedContactId | string |
De bijbehorende contactpersoon-id. |
|
|
Threadstatus
|
threadStatus | string |
De threadstatus. |
|
|
Laatste tijdstempel
|
latestMessageTimestampAfter | string |
De laatste tijdstempel van het bericht erna. |
|
|
Gearchiveerde
|
archived | boolean |
Of het nu gearchiveerd is. |
|
|
vastgoed
|
property | string |
De eigenschap. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
Gekoppelde contactpersoon-id
|
results.associatedContactId | string |
De bijbehorende contactpersoon-id. |
|
Gemaakt op
|
results.createdAt | string |
Wanneer gemaakt op. |
|
ID-kaart
|
results.id | string |
De id. |
|
Postvak IN-id
|
results.inboxId | string |
De Postvak IN-id. |
|
Spam
|
results.spam | boolean |
Of spam. |
|
Toestand
|
results.status | string |
De status. |
|
Gesloten om
|
results.closedAt | string |
Als het gesloten is. |
|
Laatste tijdstempel van bericht
|
results.latestMessageTimestamp | string |
De laatste tijdstempel van het bericht. |
|
Laatste bericht verzonden tijdstempel
|
results.latestMessageSentTimestamp | string |
Het meest recente bericht dat een tijdstempel heeft verzonden. |
|
Laatste bericht ontvangen tijdstempel
|
results.latestMessageReceivedTimestamp | string |
Het laatste bericht heeft een tijdstempel ontvangen. |
|
Assigned To
|
results.assignedTo | string |
De toegewezen aan. |
|
Gearchiveerde
|
results.archived | boolean |
Of het nu gearchiveerd is. |
|
Na
|
paging.next.after | string |
De koppeling Na. |
|
Link
|
paging.next.link | string |
De koppeling. |
Definities
touw
Dit is het basisgegevenstype 'tekenreeks'.