Format phone number
The Format phone number robot normalizes a phone number to a chosen format in Bitrix24 business processes and robots. It accepts one or several numbers in any notation — with spaces, brackets, dashes — plus a format option: +7, 8, or international. It returns the normalized number, a Y/N recognition flag, and a digits-only string.
The robot brings phone numbers to a single canonical form: it strips spaces, brackets, and dashes, then formats the number by the selected template — +7XXXXXXXXXX, 8XXXXXXXXXX, or international +XXXXXXXXXXX. The phone field is multiple, so one run can process several numbers at once. Typical cases: normalizing a lead's phone after a web form submission so duplicate search works correctly, and preparing a number before sending an SMS or placing a call through telephony. The robot returns the normalized number, a "Number recognized" Y/N flag, and a digits-only variant without the plus sign. Use the results in the next workflow steps: write the number back to an entity field, branch on the Y/N flag, or pass the digits string to an external integration.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Phone number | string | yes | |
| Format | select | yes | +7 |
What does the robot return?
| Parameter | Type |
|---|---|
| Normalized number | string |
| Number recognized (Y/N) | string |
| Digits only (no +) | string |
Scenario: phone normalization on lead creation
- A lead is created from a web form — the phone is stored as 8 (912) 345-67-89
- The robot formats the number to +79123456789
- Duplicate search by phone and telephony now work with a single format