Formatar telefones da entidade por ID: prefixo próprio
O robô «Formatar telefones da entidade por ID: prefixo próprio» converte todos os telefones de um lead, contato ou empresa, indicados por tipo e ID, para «prefixo + dígitos» — a partir de qualquer contexto de processo de negócios no Bitrix24. O prefixo é um campo de texto (+, +1, +44 etc.); se um número já começa pelos dígitos do prefixo, eles não são duplicados. Retorna a quantidade de números atualizados e ignorados.
O robô formata os telefones de uma entidade arbitrária — um lead, contato ou empresa informados explicitamente por tipo e ID, mesmo quando o processo de negócios é executado sobre outra entidade de CRM (por exemplo, o processo de um negócio normaliza os telefones do contato vinculado). Cada número é limpo de espaços, parênteses e hífens e gravado como «prefixo + dígitos»; cada número preserva o seu tipo e os demais dados de contato não são afetados. Se um número já começa pelos dígitos do prefixo, eles não são duplicados; valores com menos de 7 dígitos entram no contador de ignorados. O robô não converte códigos de tronco nacionais. Casos típicos: normalizar os telefones do contato vinculado a partir do processo de um negócio e uma limpeza em massa da base por uma lista de IDs. Retorna «Números atualizados» e «Ignorados» para condições e notificações nas próximas etapas.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Tipo de entidade | select | sim | contact |
| ID da entidade | int | sim | |
| Prefixo (código do país) | string | — | + |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Números atualizados | int |
| Ignorados (não reconhecidos) | int |
Cenário: normalizar os telefones de um contato vinculado a partir de um processo de negócio
- No processo de negócios do negócio adicione o robô «Formatar telefones da entidade por ID: prefixo próprio»
- Escolha o tipo Contato, no ID informe o contato do negócio, prefixo +44
- O robô converte todos os números do contato para +44XXXXXXXXXX e retorna a quantidade de atualizados e ignorados