Actualización de la API: Múltiples contactos por oportunidad

Daria de Flowlu

Gerente Líder de Marketing de Producto

28 de enero de 2026

4 lectura mínima

Este artículo explica qué cambió, cómo funciona el nuevo enfoque y qué deben saber los usuarios de la API.

Qué cambió al crear vínculos de oportunidades

Antes

Al crear o actualizar una oportunidad, los vínculos con contactos y organizaciones se configuraban directamente mediante campos de la propia oportunidad:

• customer_id — se utilizaba para vincular una organización
• contact_id — se utilizaba para vincular un contacto

Este enfoque permitía vincular solo dos cuentas de CRM a una oportunidad: una organización y un contacto.

Como resultado, no era posible asociar varios contactos a la misma oportunidad.

Ahora

Se ha introducido un nuevo endpoint:
crm/lead_accounts/create

Este endpoint está diseñado específicamente para crear vínculos entre cuentas de CRM y una oportunidad.

La principal diferencia con el enfoque anterior es la compatibilidad con múltiples cuentas de CRM vinculadas a una sola oportunidad, lo que permite vincular varios contactos a la misma oportunidad.

Este cambio proporciona una forma más flexible y explícita de gestionar las relaciones de las oportunidades.

Estructura de la solicitud

El endpoint acepta los siguientes parámetros:

• lead_id — ID de la oportunidad a la que se vincula la cuenta (obligatorio)
• account_id — ID de la cuenta de CRM que se vincula (obligatorio)
• account_type — tipo de cuenta de CRM (obligatorio):

1 — organización

2 — contacto

• created_at — campo del sistema, se completa automáticamente
• updated_at — campo del sistema, se completa automáticamente

Qué cambió al obtener datos de la oportunidad

Antes

Al obtener una oportunidad, la respuesta incluía:

• customer_id
• contact_id

Esto permitía obtener solo dos cuentas de CRM vinculadas: una organización y un contacto.

Ahora

Los campos customer_id y contact_id ya no se devuelven como parte de la entidad de la oportunidad y ya no se utilizan para obtener vínculos con cuentas de CRM.

Para obtener información sobre las cuentas de CRM vinculadas a una oportunidad, la API ahora ofrece endpoints dedicados:

• crm/lead_accounts/get/{id} — obtener un vínculo específico entre oportunidad y cuenta
• crm/lead_accounts/list — obtener todas las cuentas de CRM vinculadas a una oportunidad

Este enfoque admite completamente múltiples vínculos de contactos y es la forma actual y compatible de acceder a los datos de relaciones.

Compatibilidad con versiones anteriores

No se admite la compatibilidad con versiones anteriores.

Si tu integración depende de:

• establecer customer_id o contact_id al crear oportunidades, o
• leer estos campos en las respuestas de oportunidades,

deberás actualizarla para usar el nuevo enfoque de la API.

Si no utilizas la API de Flowlu, esta actualización no te afecta.

Documentación

Los detalles técnicos completos están disponibles en la documentación de la API.