Skip to content

Migration guide · Customer Service

Legacy phone system to Aircall migration

On-premise or legacy phone systemsAircall

Short answer

Moving from a legacy phone system to Aircall replaces desk phones and on-premise systems with cloud telephony that logs calls, recordings and notes directly into HubSpot or Salesforce.

Why firms make this move

Legacy phone systems keep calls outside the CRM, so managers lack visibility and compliance reviews are manual. Aircall brings click-to-call, call logging, routing based on CRM data, and AI call summaries. The move covers number porting, call flows, user setup and CRM integration.

What moves

  • Phone numbers (ported)
  • Call flows, queues and business hours
  • Users and teams
  • CRM integration and logging rules

How the data maps

FromTo
Desk phone extensionAircall user and number
Hunt groupAircall team or ring group
IVRAircall IVR
Call recordingAircall recording logged to CRM

See the field-by-field map ↓

What to watch out for

  • Number porting lead times
  • Recording consent and retention
  • Users' headsets and devices

How Vantage Point runs the migration

  1. Inventory numbers and call flows
  2. Design routing and teams
  3. Configure Aircall and the CRM integration
  4. Port numbers
  5. Train users and go live

Typical timeline

Typically 2 to 6 weeks, depending on number porting.

Frequently asked questions

How long does number porting take?

It depends on the carrier, typically a few weeks. We plan the cutover around it.

Will calls log to HubSpot or Salesforce automatically?

Yes. Aircall logs calls, recordings and notes to the matching CRM record.

Last reviewed October 2, 2026 by the Vantage Point team. Browse all migration paths →

Field-level map

Legacy phone system to Aircall: field by field

6 mappings we start from on this migration, 6 of which need a transform, a lookup or a decision. Every project gets its own signed-off version; this is the baseline.

FromToHowNotes
Phone numbersDirect and main numbers Aircall numbersPorted numbers req manual review Porting needs a letter of authorization and lead time.
Hunt groups / ring groupsRouting Aircall teams & call distribution— req rebuild
Auto attendant / IVRMenus Aircall IVR— rebuild
Voicemail boxesGreetings Aircall voicemail— rebuild
Users / extensionsUsers Aircall users— req lookup
Call historyOld call logs —— drop Archive if needed; new calls log to the CRM.

Field names are the platforms' standard API names; your org's custom fields are mapped during discovery. What the "How" labels mean

How labels
direct
Value copies across unchanged.
picklist map
Each source value is mapped to a target value.
lookup
Matched to an existing record, such as a user by email.
association
Becomes a relationship between records, loaded in a later pass.
derive
Calculated or cleaned during the load.
split / concat
One field becomes several, or several become one.
rebuild
Configuration or automation that is rebuilt rather than moved.
drop
Not migrated, deliberately.
manual review
Needs a decision with your team before the load.