Format entity phone numbers by ID: custom prefix
The Format entity phone numbers by ID: custom prefix robot converts every phone of a lead, contact or company given by type and ID to "prefix + digits" — from any business-process context in Bitrix24. The prefix is a text input (+, +1, +44 and the like); when a number already starts with the prefix digits they are not doubled. It returns the updated and skipped counts.
The robot formats the phones of an arbitrary entity — a lead, contact or company given explicitly by type and ID, even when the business process runs on a different CRM entity (for example a deal's process normalising the linked contact's phones). Every number is cleaned of spaces, brackets and dashes and written back as "prefix + digits"; each number keeps its type and other contact data stays untouched. If a number already begins with the prefix digits they are not doubled; values shorter than 7 digits are counted as skipped. The robot does not convert national trunk codes. Typical cases: normalising a linked contact's phones from a deal process, and a bulk database cleanup by an ID list. It returns the updated and skipped counts for conditions and notifications in the next steps.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Entity type | select | yes | contact |
| Entity ID | int | yes | |
| Prefix (country code) | string | — | + |
What does the robot return?
| Parameter | Type |
|---|---|
| Numbers updated | int |
| Skipped (not recognised) | int |
Scenario: normalising a linked contact's phones from a deal process
- In the deal business process add the Format entity phone numbers by ID: custom prefix robot
- Choose type Contact, set ID to the deal's contact, prefix +44
- The robot converts all the contact's numbers to +44XXXXXXXXXX and returns the updated and skipped counts