Vincular tarefa ao CRM (por ID)
O robô «Vincular tarefa ao CRM (por ID)» gerencia o vínculo de uma tarefa do Bitrix24 (Alaio) com elementos CRM: vincula, desvincula ou substitui um contato, empresa, negócio ou lead em uma tarefa pelo seu ID. «Substituir» troca o elemento do mesmo tipo mantendo os vínculos de outros tipos. Retorna Sucesso, um indicador de Alterado e a lista resultante de vínculos.
O robô edita o campo UF_CRM_TASK de uma tarefa pelo seu ID — o vínculo da tarefa com elementos CRM. Entradas: ID da tarefa, tipo de elemento (contato/empresa/negócio/lead), ID do elemento e um modo. Modos: «Vincular» adiciona um vínculo sem afetar os demais; «Desvincular» remove apenas o indicado; «Substituir» remove todos os vínculos do mesmo tipo e define o novo (vínculos de outros tipos são mantidos). Todas as operações são idempotentes: quando não há nada a alterar, o robô retorna Alterado = N e ignora a gravação. Use a partir de um processo de negócios de negócio ou contato para vincular o elemento correto a uma tarefa relacionada. Retorna Sucesso (Y/N), Alterado (Y/N) e a lista de vínculos resultante como CONTACT_7, DEAL_10 — que pode ser passada ao robô de busca de tarefas.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID da tarefa | int | sim | |
| Tipo de elemento CRM | select | sim | contact |
| ID do elemento CRM | int | sim | |
| O que fazer | select | sim | replace |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
| Vínculo alterado (Y/N) | string |
| Vínculos atuais (CONTACT_7, DEAL_10…) | string |
Cenário: substituir o contato de uma tarefa a partir de um processo de negócio
- Um processo de negócios de negócio chega à etapa correspondente
- O robô com modo Substituir, tipo Contato, o novo ID de contato e o ID da tarefa
- O robô retorna Sucesso = Y e a lista de vínculos com o novo contato