Vincular contactos a una negociación
El robot «Vincular contactos a una negociación» vincula uno o varios contactos por sus ID a una negociación de Bitrix24 (Alaio), directamente en una regla de automatización o en un proceso de negocio. El modo «añadir» agrega a los contactos ya vinculados; el modo «reemplazar» deja solo los indicados. Devuelve un indicador de éxito, el número de contactos vinculados y la lista resultante de ID.
Una negociación puede tener varios contactos, pero el robot estándar «Modificar documento» solo cambia el principal, y las demás vinculaciones se pierden con facilidad por el camino. Este robot gestiona la lista completa. Indique un ID de contacto o varios, separados por comas, desde una variable o desde el resultado de otro robot como «Buscar contacto por teléfono». Por defecto el robot trabaja con la negociación sobre la que se ejecuta el proceso, pero puede indicarse el ID de cualquier negociación. El modo «Añadir» agrega los contactos a los ya vinculados y omite los que ya existen; el modo «Reemplazar» deja solo los indicados, y el primero pasa a ser el principal. Devuelve Éxito (Y/N), el número de contactos vinculados en esta ejecución y la lista completa de ID de contactos vinculados tras la ejecución, lista para condiciones y pasos siguientes.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| ID de la negociación (vacío — la negociación sobre la que se ejecuta el proceso) | int | — | |
| ID de contactos (uno o varios) | string | sí | |
| Modo | select | — | add |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Éxito (Y/N) | string |
| Contactos vinculados en esta ejecución | int |
| ID de todos los contactos vinculados tras la ejecución | 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: no se indicó el ID y el proceso se ejecuta sobre otro elemento
- Error: no se indicó ningún ID de contacto válido
- Error: demasiados contactos, el límite es {max}
- Error de la API: {message}
- No se pudieron vincular los contactos: {ids}
- Contactos no encontrados: {ids}
Escenario: una negociación con una empresa que tiene varios representantes
- El proceso reúne los ID de todos los contactos de la empresa
- Este robot, en modo «Añadir», los vincula a la negociación en un solo paso
- Los correos y llamadas de la negociación ya se ven en cada participante