Vincular contatos a um negócio
O robô «Vincular contatos a um negócio» vincula um ou vários contatos pelos seus IDs a um negócio do Bitrix24 (Alaio), diretamente em uma regra de automação ou em um processo de negócios. O modo «adicionar» acrescenta aos contatos já vinculados; o modo «substituir» mantém apenas os indicados. Retorna um indicador de sucesso, o número de contatos vinculados e a lista resultante de IDs.
Um negócio pode ter vários contatos, mas o robô padrão «Alterar documento» altera apenas o principal, e os demais vínculos se perdem facilmente no caminho. Este robô gerencia a lista inteira. Informe um ID de contato ou vários, separados por vírgula, de uma variável ou do resultado de outro robô, como «Encontrar contato por telefone». Por padrão o robô trabalha com o negócio em que o processo está rodando, mas o ID de qualquer negócio pode ser informado. O modo «Adicionar» acrescenta os contatos aos já vinculados e pula os que já existem; o modo «Substituir» mantém apenas os indicados, e o primeiro passa a ser o principal. Retorna Sucesso (Y/N), o número de contatos vinculados nesta execução e a lista completa de IDs de contatos vinculados após a execução, pronta para condições e próximas etapas.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID do negócio (vazio — o negócio em que o processo está rodando) | int | — | |
| IDs de contatos (um ou vários) | string | sim | |
| Modo | select | — | add |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
| Contatos vinculados nesta execução | int |
| IDs de todos os contatos vinculados após a execução | string |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- Erro: o ID não foi informado e o processo roda em outro elemento
- Erro: nenhum ID de contato válido foi informado
- Erro: contatos demais, o limite é {max}
- Erro da API: {message}
- Não foi possível vincular os contatos: {ids}
- Contatos não encontrados: {ids}
Cenário: um negócio com uma empresa que tem vários representantes
- O processo reúne os IDs de todos os contatos da empresa
- Este robô, no modo «Adicionar», vincula todos ao negócio em uma única etapa
- E-mails e ligações do negócio agora aparecem em cada participante