Vincular contactos a un prospecto
El robot «Vincular contactos a un prospecto» vincula uno o varios contactos por sus ID a un prospecto 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.
El robot estándar «Modificar documento» no puede vincular un contacto a un prospecto: en la lista de campos del prospecto no existe ese campo, porque los contactos se guardan como una vinculación aparte. Este robot cubre esa carencia. 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 el prospecto sobre el que se ejecuta el proceso, pero puede indicarse el ID de cualquier prospecto. 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 del prospecto (vacío — el prospecto sobre el 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: un prospecto nuevo desde el teléfono de un cliente existente
- En el CRM se crea un prospecto con un número de teléfono
- El robot «Buscar contacto por teléfono» encuentra el contacto y devuelve su ID
- Este robot vincula el contacto encontrado al prospecto, y el gestor ve de inmediato el historial del cliente