Vincular tarea a CRM (por ID)
El robot «Vincular tarea a CRM (por ID)» gestiona el vínculo de una tarea de Bitrix24 (Alaio) con elementos CRM: vincula, desvincula o reemplaza un contacto, empresa, negociación o prospecto en una tarea por su ID. «Reemplazar» cambia el elemento del mismo tipo conservando los vínculos de otros tipos. Devuelve Éxito, un indicador de Modificado y la lista resultante de vínculos.
El robot edita el campo UF_CRM_TASK de una tarea por su ID — el vínculo de la tarea con elementos CRM. Entradas: ID de la tarea, tipo de elemento (contacto/empresa/negociación/prospecto), ID del elemento y un modo. Modos: «Vincular» añade un vínculo sin tocar los demás; «Desvincular» elimina solo el indicado; «Reemplazar» elimina todos los vínculos del mismo tipo y establece el nuevo (los vínculos de otros tipos se conservan). Todas las operaciones son idempotentes: cuando no hay nada que cambiar, el robot devuelve Modificado = N y omite la escritura. Úselo desde un proceso de negocio de negociación o contacto para vincular el elemento correcto a una tarea relacionada. Devuelve Éxito (Y/N), Modificado (Y/N) y la lista de vínculos resultante como CONTACT_7, DEAL_10 — que puede pasarse al robot de búsqueda de tareas.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| ID de la tarea | int | sí | |
| Tipo de elemento CRM | select | sí | contact |
| ID del elemento CRM | int | sí | |
| Qué hacer | select | sí | replace |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Éxito (Y/N) | string |
| Vínculo modificado (Y/N) | string |
| Vínculos actuales (CONTACT_7, DEAL_10…) | string |
¿Qué errores puede devolver el robot?
El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.
- Error: parámetros no válidos (tipo/ID de elemento o modo)
- Error: no se ha proporcionado el ID de la tarea
- Error: el robot de «tarea actual» debe ejecutarse desde la automatización o el proceso de negocio de la propia tarea
- Error de API
Escenario: reemplazar el contacto de una tarea desde un proceso de negociación
- Un proceso de negocio de negociación llega al paso correspondiente
- El robot con modo Reemplazar, tipo Contacto, el nuevo ID de contacto y el ID de la tarea
- El robot devuelve Éxito = Y y la lista de vínculos con el nuevo contacto