Asociaciones v3

ResumenPuntos de terminación de asociaciónPuntos de terminación de esquema de asociación

There is a new version of the Associations API that adds the ability to create multiple types of associations between two object types.

Las asociaciones representan las relaciones entre objetos y actividades en el CRM. Puedes usar los puntos de terminación de las asociaciones para crear, recuperar o eliminar asociaciones de forma masiva. Puedes asociar los siguientes objetos o interacciones a través de la API de asociaciones:

  • Contacts
  • Companies
  • Deals
  • Tickets
  • Calls
  • Quotes
  • Line_items
  • Meetings
  • Products
  • Feedback_submissions
  • Custom objects (el nombre del objeto)

Obtén más información sobre las API de objetos, registros, propiedades y asociaciones en la guía Comprender el CRM . Para obtener más información general sobre objetos y registros de HubSpot, aprende a administrar la base de datos del CRM.

Please note: this API doesn't support parent-child associations or special contact-to-company associations. Learn more about how you can use these associations with the previous version of the associations API.

Definiciones de asociación

Las asociaciones se definen por el objeto y la dirección. Los tipos de asociaciones son unidireccionales, lo que significa que deberás usar una definición diferente según el tipo de objeto inicial. Por ejemplo:

  • Para ver todos los tickets asociados con un contacto, debes definir la asociación con la URL de la solicitud /crm/v3/associations/Contacts/Tickets/batch/read e identificar el contacto en el cuerpo de la solicitud por su objectId. En este ejemplo, Contactos es fromObjectType y Tickets es toObjectType.
  • Para asociar un registro de contacto con un registro de objeto personalizado, donde el objeto personalizado es Mascotas, debes definir la asociación con la URL de la solicitud /crm/v3/associations/Pets/Contacts/batch/create e identificar los registros de contactos y de mascotas que deseas asociar en el cuerpo de la solicitud por sus objectIds. En este ejemplo, Mascotas es el fromObjectType y Contactos es el toObjectType.

Para ver todos los tipos de asociaciones definidos entre objetos, realiza una solicitud GET en /crm/v3/associations/{fromObjectType}/{toObjectType}/types.

Crear asociaciones

Para asociar registros en HubSpot, haz una solicitud POST en /crm/v3/associations/{fromObjectType}/{toObjectType}/batch/create. En la solicitud, incluye los valores de id de los registros que deseas asociar, así como el type de asociación a la que pertenecen los registros.

Por ejemplo, para asociar contactos a empresas, la URL de tu solicitud sería /crm/v3/associations/Contacts/Companies/batch/create, y la solicitud sería similar a la siguiente:

///Example request body { "inputs": [ { "from": { "id": "53628" }, "to": { "id": "12726" }, "type": "contact_to_company" } ] }

Recuperar asociaciones

Para recuperar los registros asociados, haz una solicitud POST en /crm/v3/associations/{fromObjectType}/{toObjectType}/batch/read. En tu solicitud, puedes incluir el id de un registro específico para el fromObjectType. En tu respuesta, recibirás los valores de id de todos los registros asociados de toObjectType.

Por ejemplo, para recuperar todos los negocios asociados con una empresa, la URL de la solicitud se vería así /crm/v3/associations/Companies/Deals/batch/read. Tu respuesta incluiría los valores id de todos los negocios asociados.

Eliminar asociaciones

Para eliminar asociaciones entre registros, haz una solicitud POST en /crm/v3/associations/{fromObjectType}/{toObjectType}/batch/archive.

¿Te resultó útil este artículo?
Con este formulario puedes enviar tu opinión sobre nuestros documentos para desarrolladores. Si tienes comentarios sobre el producto de HubSpot, puedes enviarlos al Foro de ideas.