Conversaciones de HubSpot V2 (publicador independiente) (versión preliminar)
Los servicios de conversaciones de HubSpot le permiten administrar e interactuar con la bandeja de entrada, los canales y los mensajes de las conversaciones.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| Correo Electrónico | ttaylor@hitachisolutions.com |
| Metadatos del conector | |
|---|---|
| Publicador | Troy Taylor |
| Sitio web | https://www.hubspot.com/products/crm/conversations |
| Directiva de privacidad | https://legal.hubspot.com/privacy-policy |
| Categorías | Marketing; Ventas y CRM |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Token de acceso (en el formato "Bearer YOUR_ACCESS_TOKEN") | securestring | Token de acceso (con el formato "Bearer YOUR_ACCESS_TOKEN") para esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar un subproceso |
Actualiza un único subproceso. Se puede actualizar el estado de un subproceso o se puede restaurar el subproceso. |
| Archiva un subproceso |
Archiva un único subproceso. El subproceso se eliminará permanentemente 30 días después de colocarlo en un estado archivado. |
| Enviar un mensaje a un subproceso |
Envíe un mensaje nuevo en un subproceso en la marca de tiempo actual. |
| Generar un símbolo |
Genera un nuevo token de identificación de visitante. Este token será único cada vez que se llame a este punto de conexión, incluso si se llama con la misma dirección de correo electrónico. Este token es temporal y expirará después de 12 horas. |
| Obtención de cuentas de canal |
Recuperar una lista de cuentas de canal. |
| Obtención de una sola cuenta de canal |
Recuperar una sola cuenta de canal. |
| Obtener actores |
Resuelva los identificadores de actores en los actores y participantes subyacentes. |
| Obtener bandejas de entrada de conversaciones |
Recuperar una lista de las bandejas de entrada de conversaciones. |
| Obtener canales |
Recuperar una lista de canales. |
| Obtener el contenido original de un único mensaje |
Devuelve el texto original completo y los cuerpos de texto enriquecido de un mensaje. Esto será diferente del texto y el texto enriquecido del propio mensaje si el valor de truncationStatus del mensaje es distinto de NOT_TRUNCATED. |
| Obtener el historial de mensajes de un subproceso |
Recupere una lista del historial de mensajes de un subproceso. |
| Obtener subprocesos |
Recuperar una lista de subprocesos. |
| Obtener un solo actor |
Recuperar un solo actor. |
| Obtener un único canal |
Recuperar un único canal. |
| Obtener un único mensaje |
Recuperar un único mensaje. |
| Obtener un único subproceso |
Recupera un único subproceso. |
| Obtener una sola bandeja de entrada de conversaciones |
Recuperar una sola bandeja de entrada de conversaciones. |
Actualizar un subproceso
Actualiza un único subproceso. Se puede actualizar el estado de un subproceso o se puede restaurar el subproceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Archivado
|
archived | boolean |
Si está archivado. |
|
|
Identificador de subproceso
|
threadId | True | string |
Identificador del subproceso. |
|
Estado
|
status | string |
Estado. |
|
|
Archivado
|
archived | boolean |
Si está archivado. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de contacto asociado
|
associatedContactId | string |
Identificador de contacto asociado. |
|
Creado en
|
createdAt | string |
Cuando se crea en . |
|
identificación
|
id | string |
Identificador. |
|
Id. de bandeja de entrada
|
inboxId | string |
Identificador de la bandeja de entrada. |
|
Correo no deseado
|
spam | boolean |
El correo no deseado. |
|
Estado
|
status | string |
Estado. |
|
Cerrado en
|
closedAt | string |
Cuando se cierra. |
|
Marca de tiempo del mensaje más reciente
|
latestMessageTimestamp | string |
Marca de tiempo del mensaje más reciente. |
|
Marca de tiempo de envío del mensaje más reciente
|
latestMessageSentTimestamp | string |
El mensaje más reciente envió la marca de tiempo. |
|
Marca de tiempo recibida del mensaje más reciente
|
latestMessageReceivedTimestamp | string |
El mensaje más reciente recibió la marca de tiempo. |
|
Asignado a
|
assignedTo | string |
Asignado a. |
|
Archivado
|
archived | boolean |
Si está archivado. |
Archiva un subproceso
Archiva un único subproceso. El subproceso se eliminará permanentemente 30 días después de colocarlo en un estado archivado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de subproceso
|
threadId | True | string |
Identificador del subproceso. |
Devoluciones
- response
- string
Enviar un mensaje a un subproceso
Envíe un mensaje nuevo en un subproceso en la marca de tiempo actual.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de subproceso
|
threadId | True | string |
Identificador del subproceso. |
|
Attachments
|
attachments | array of |
Objeto attachments. |
|
|
Id. de cuenta de canal
|
channelAccountId | string |
Identificador de la cuenta de canal. |
|
|
Id. de canal
|
channelId | string |
Identificador del canal. |
|
|
Tipo
|
type | string |
Tipo. |
|
|
Importancia
|
value | string |
Valor. |
|
|
Id. de actor
|
actorId | string |
Identificador del actor. |
|
|
Nombre
|
name | string |
Nombre. |
|
|
Campo destinatario
|
recipientField | string |
Campo destinatario. |
|
|
Tipo
|
type | string |
Tipo. |
|
|
Importancia
|
value | string |
Valor. |
|
|
Id. de actor de remitente
|
senderActorId | string |
Identificador del actor remitente. |
|
|
Mensaje de texto
|
text | string |
Texto. |
|
|
Tipo
|
type | string |
Tipo. |
|
|
Texto enriquecido
|
richText | string |
El texto rick. |
|
|
Asunto
|
subject | string |
El asunto. |
Devoluciones
- response
- string
Generar un símbolo
Genera un nuevo token de identificación de visitante. Este token será único cada vez que se llame a este punto de conexión, incluso si se llama con la misma dirección de correo electrónico. Este token es temporal y expirará después de 12 horas.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Correo Electrónico
|
string |
Dirección de correo electrónico. |
||
|
Nombre
|
firstName | string |
Nombre. |
|
|
Apellido
|
lastName | string |
Apellidos. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Token
|
token | string |
El token. |
Obtención de cuentas de canal
Recuperar una lista de cuentas de canal.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de canal
|
channelId | string |
Identificador del canal. |
|
|
Id. de bandeja de entrada
|
inboxId | string |
Identificador de la bandeja de entrada. |
|
|
Después
|
after | string |
Vínculo Después. |
|
|
Limit
|
limit | string |
Límite de respuesta. |
|
|
Ordenar
|
sort | string |
Criterio de ordenación. |
|
|
Longitud de página
|
defaultPageLength | string |
Longitud de página predeterminada. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
identificación
|
results.id | string |
Identificador. |
|
Id. de canal
|
results.channelId | string |
Identificador del canal. |
|
Nombre
|
results.name | string |
Nombre. |
|
Id. de bandeja de entrada
|
results.inboxId | string |
Identificador de la bandeja de entrada. |
|
Active
|
results.active | boolean |
Si está activo. |
|
Autorizado
|
results.authorized | boolean |
Si está autorizado. |
|
Creado en
|
results.createdAt | string |
Cuando se crea en . |
|
Tipo
|
results.deliveryIdentifier.type | string |
Tipo. |
|
Importancia
|
results.deliveryIdentifier.value | string |
Valor. |
|
Total
|
total | integer |
Total. |
|
Después
|
paging.next.after | string |
Vínculo Después. |
|
Link
|
paging.next.link | string |
Vínculo. |
Obtención de una sola cuenta de canal
Recuperar una sola cuenta de canal.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de cuenta de canal
|
channelAccountId | True | string |
Identificador de la cuenta de canal. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador. |
|
Id. de canal
|
channelId | string |
Identificador del canal. |
|
Nombre
|
name | string |
Nombre. |
|
Id. de bandeja de entrada
|
inboxId | string |
Identificador de la bandeja de entrada. |
|
Active
|
active | boolean |
Si está activo. |
|
Autorizado
|
authorized | boolean |
Si está autorizado. |
|
Creado en
|
createdAt | string |
Cuando se crea en . |
|
Tipo
|
deliveryIdentifier.type | string |
Tipo. |
|
Importancia
|
deliveryIdentifier.value | string |
Valor. |
Obtener actores
Resuelva los identificadores de actores en los actores y participantes subyacentes.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propiedad . |
|
|
Entradas
|
inputs | array of string |
Entradas. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Completado en
|
completedAt | string |
Cuando se complete en. |
|
Results
|
results | array of object | |
|
identificación
|
results.id | string |
Identificador. |
|
Tipo
|
results.type | string |
Tipo. |
|
Nombre
|
results.name | string |
Nombre. |
|
Correo Electrónico
|
results.email | string |
Dirección de correo electrónico. |
|
Avatar
|
results.avatar | string |
El avatar. |
|
Iniciado en
|
startedAt | string |
Cuando se inicia en. |
|
Estado
|
status | string |
Estado. |
|
Solicitado en
|
requestedAt | string |
Cuando se solicite en . |
Obtener bandejas de entrada de conversaciones
Recuperar una lista de las bandejas de entrada de conversaciones.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Después
|
after | string |
Vínculo Después. |
|
|
Limit
|
limit | string |
Límite de respuesta. |
|
|
Ordenar
|
sort | string |
Criterio de ordenación. |
|
|
Longitud de página
|
defaultPageLength | string |
Longitud de página predeterminada. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
identificación
|
results.id | string |
Identificador. |
|
Nombre
|
results.name | string |
Nombre. |
|
Creado en
|
results.createdAt | string |
Cuando se crea en . |
|
Actualizado en
|
results.updatedAt | string |
Cuando se actualiza en . |
|
Total
|
total | integer |
Total. |
|
Después
|
paging.next.after | string |
Vínculo Después. |
|
Link
|
paging.next.link | string |
Vínculo. |
Obtener canales
Recuperar una lista de canales.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Después
|
after | string |
Vínculo Después. |
|
|
Limit
|
limit | string |
Límite de respuesta. |
|
|
Ordenar
|
sort | string |
Criterio de ordenación. |
|
|
Longitud de página
|
defaultPageLength | string |
Longitud de página predeterminada. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
identificación
|
results.id | string |
Identificador. |
|
Nombre
|
results.name | string |
Nombre. |
|
Total
|
total | integer |
Total. |
|
Después
|
paging.next.after | string |
Vínculo Después. |
|
Link
|
paging.next.link | string |
Vínculo. |
Obtener el contenido original de un único mensaje
Devuelve el texto original completo y los cuerpos de texto enriquecido de un mensaje. Esto será diferente del texto y el texto enriquecido del propio mensaje si el valor de truncationStatus del mensaje es distinto de NOT_TRUNCATED.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propiedad . |
|
|
Identificador de subproceso
|
threadId | True | string |
Identificador del subproceso. |
|
Id. de mensaje
|
messageId | True | string |
Identificador del mensaje. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Mensaje de texto
|
text | string |
Texto. |
|
Texto enriquecido
|
richText | string |
El texto rick. |
Obtener el historial de mensajes de un subproceso
Recupere una lista del historial de mensajes de un subproceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Después
|
after | string |
Vínculo Después. |
|
|
Limit
|
limit | string |
Límite de respuesta. |
|
|
Ordenar
|
sort | string |
Criterio de ordenación. |
|
|
Archivado
|
archived | boolean |
Si está archivado. |
|
|
property
|
property | string |
Propiedad . |
|
|
Identificador de subproceso
|
threadId | True | string |
Identificador del subproceso. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
Archivado
|
results.archived | boolean |
Si está archivado. |
|
Tipo de cliente:
|
results.client.clientType | string |
Tipo de cliente. |
|
Id. de aplicación de integración
|
results.client.integrationAppId | string |
Identificador de la aplicación de integración. |
|
Creado en
|
results.createdAt | string |
Cuando se crea en . |
|
Autor
|
results.createdBy | string |
Objeto creado por. |
|
Dirección
|
results.direction | string |
La dirección. |
|
identificación
|
results.id | string |
Identificador. |
|
Recipientes
|
results.recipients | array of object | |
|
Tipo
|
results.recipients.deliveryIdentifier.type | string |
Tipo. |
|
Importancia
|
results.recipients.deliveryIdentifier.value | string |
Valor. |
|
Id. de actor
|
results.recipients.actorId | string |
Identificador del actor. |
|
Nombre
|
results.recipients.name | string |
Nombre. |
|
Campo destinatario
|
results.recipients.recipientField | string |
Campo destinatario. |
|
Remitentes
|
results.senders | array of object | |
|
Id. de actor
|
results.senders.actorId | string |
Identificador del actor. |
|
Nombre
|
results.senders.name | string |
Nombre. |
|
Campo remitente
|
results.senders.senderField | string |
Campo remitente. |
|
Tipo
|
results.senders.deliveryIdentifier.type | string |
Tipo. |
|
Importancia
|
results.senders.deliveryIdentifier.value | string |
Valor. |
|
Mensaje de texto
|
results.text | string |
Texto. |
|
Estado de truncamiento
|
results.truncationStatus | string |
Estado de truncamiento. |
|
Tipo
|
results.type | string |
Tipo. |
|
Actualizado en
|
results.updatedAt | string |
Cuando se actualiza en . |
|
Texto enriquecido
|
results.richText | string |
Texto enriquecido. |
|
Asunto
|
results.subject | string |
El asunto. |
|
En Respuesta al identificador
|
results.inReplyToId | string |
en respuesta al identificador. |
|
Tipo de estado
|
results.status.statusType | string |
Tipo de estado. |
|
Mensaje de error
|
results.status.failureDetails.errorMessage | string |
El mensaje de error. |
|
Id. de canal
|
results.channelId | string |
Identificador del canal. |
|
Id. de cuenta de canal
|
results.channelAccountId | string |
Identificador de la cuenta de canal. |
|
Identificador de subproceso de conversaciones
|
results.conversationsThreadId | string |
Identificador del subproceso de conversaciones. |
|
Después
|
paging.next.after | string |
Vínculo Después. |
|
Link
|
paging.next.link | string |
Vínculo. |
Obtener subprocesos
Recuperar una lista de subprocesos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Después
|
after | string |
Vínculo Después. |
|
|
Limit
|
limit | string |
Límite de respuesta. |
|
|
Ordenar
|
sort | string |
Criterio de ordenación. |
|
|
Id. de bandeja de entrada
|
inboxId | string |
Identificador de la bandeja de entrada. |
|
|
Id. de contacto asociado
|
associatedContactId | string |
Identificador de contacto asociado. |
|
|
Estado del subproceso
|
threadStatus | string |
Estado del subproceso. |
|
|
Marca de tiempo más reciente
|
latestMessageTimestampAfter | string |
Marca de tiempo del mensaje más reciente después. |
|
|
Archivado
|
archived | boolean |
Si está archivado. |
|
|
property
|
property | string |
Propiedad . |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Results
|
results | array of object | |
|
Id. de contacto asociado
|
results.associatedContactId | string |
Identificador de contacto asociado. |
|
Creado en
|
results.createdAt | string |
Cuando se crea en . |
|
identificación
|
results.id | string |
Identificador. |
|
Id. de bandeja de entrada
|
results.inboxId | string |
Identificador de la bandeja de entrada. |
|
Correo no deseado
|
results.spam | boolean |
Si no deseado. |
|
Estado
|
results.status | string |
Estado. |
|
Cerrado en
|
results.closedAt | string |
Cuando se cierra. |
|
Marca de tiempo del mensaje más reciente
|
results.latestMessageTimestamp | string |
Marca de tiempo del mensaje más reciente. |
|
Marca de tiempo de envío del mensaje más reciente
|
results.latestMessageSentTimestamp | string |
El mensaje más reciente envió la marca de tiempo. |
|
Marca de tiempo recibida del mensaje más reciente
|
results.latestMessageReceivedTimestamp | string |
El mensaje más reciente recibió la marca de tiempo. |
|
Asignado a
|
results.assignedTo | string |
Asignado a. |
|
Archivado
|
results.archived | boolean |
Si está archivado. |
|
Después
|
paging.next.after | string |
Vínculo Después. |
|
Link
|
paging.next.link | string |
Vínculo. |
Obtener un solo actor
Recuperar un solo actor.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propiedad . |
|
|
Id. de actor
|
actorId | True | string |
Identificador del actor. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador. |
|
Tipo
|
type | string |
Tipo. |
|
Nombre
|
name | string |
Nombre. |
|
Correo Electrónico
|
string |
Dirección de correo electrónico. |
|
|
Avatar
|
avatar | string |
El avatar. |
Obtener un único canal
Recuperar un único canal.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de canal
|
channelId | True | string |
Identificador del canal. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador. |
|
Nombre
|
name | string |
Nombre. |
Obtener un único mensaje
Recuperar un único mensaje.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
property
|
property | string |
Propiedad . |
|
|
Identificador de subproceso
|
threadId | True | string |
Identificador del subproceso. |
|
Id. de mensaje
|
messageId | True | string |
Identificador del mensaje. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Importancia
|
value | string |
Valor. |
Obtener un único subproceso
Recupera un único subproceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Archivado
|
archived | boolean |
Si está archivado. |
|
|
property
|
property | string |
Propiedad . |
|
|
Identificador de subproceso
|
threadId | True | string |
Identificador del subproceso. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de contacto asociado
|
associatedContactId | string |
Identificador de contacto asociado. |
|
Creado en
|
createdAt | string |
Cuando se crea en . |
|
identificación
|
id | string |
Identificador. |
|
Id. de bandeja de entrada
|
inboxId | string |
Identificador de la bandeja de entrada. |
|
Correo no deseado
|
spam | boolean |
El correo no deseado. |
|
Estado
|
status | string |
Estado. |
|
Cerrado en
|
closedAt | string |
Cuando se cierra. |
|
Marca de tiempo del mensaje más reciente
|
latestMessageTimestamp | string |
Marca de tiempo del mensaje más reciente. |
|
Marca de tiempo de envío del mensaje más reciente
|
latestMessageSentTimestamp | string |
El mensaje más reciente envió la marca de tiempo. |
|
Marca de tiempo recibida del mensaje más reciente
|
latestMessageReceivedTimestamp | string |
El mensaje más reciente recibió la marca de tiempo. |
|
Asignado a
|
assignedTo | string |
Asignado a. |
|
Archivado
|
archived | boolean |
Si está archivado. |
Obtener una sola bandeja de entrada de conversaciones
Recuperar una sola bandeja de entrada de conversaciones.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de bandeja de entrada
|
inboxId | True | string |
Identificador de la bandeja de entrada. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador. |
|
Nombre
|
name | string |
Nombre. |
|
Creado en
|
createdAt | string |
Cuando se crea en . |
|
Actualizado en
|
updatedAt | string |
Cuando se actualiza en . |
Definiciones
cuerda / cadena
Este es el tipo de datos básico "string".