Vincular contatos a um lead
O robô «Vincular contatos a um lead» vincula um ou vários contatos pelos seus IDs a um lead 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.
O robô padrão «Alterar documento» não consegue vincular um contato a um lead: a lista de campos do lead não tem esse campo, porque os contatos são armazenados como um vínculo separado. Este robô preenche essa lacuna. 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 lead em que o processo está rodando, mas o ID de qualquer lead 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 lead (vazio — o lead 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 novo lead do telefone de um cliente existente
- Um lead com número de telefone é criado no CRM
- O robô «Encontrar contato por telefone» encontra o contato e retorna o seu ID
- Este robô vincula o contato encontrado ao lead, e o gestor vê o histórico do cliente na hora