This article walks through the full process of activating an eSIM for an Aircall French mobile number. The process involves three roles: the Owner, the Admin, and the Agent.

Requirements

Before starting, confirm the following:

  • An eSIM add-on has been purchased (Voice+SMS, Voice+SMS+Data, or Voice+SMS+Data Pro)
  • The number to be used is a French or Spanish mobile number
  • The agent's smartphone supports eSIM technology

Step 1: Owner purchases the eSIM add-on

  1. Log in to the Aircall Dashboard with Owner permissions
  2. Click your company name, then go to the Plan tab
  3. In the Add-on panel, select Buy eSIMs
  4. Purchase the required number of eSIM licenses for your account
eSIMs pricing

The eSIM add-on is billed monthly in addition to your existing plan.

Step 2: Admin assigns the license to a French or Spanish mobile number

  1. Go Aircall Dashboard > Numbers

  2. Select the French or Spanish mobile number you want to assign an eSIM to

    french number
  3. Open the Integrations tab
integrations tab

If it's a French number currently configured as a shared line, update the call flow to convert it to a direct number before continuing. For more details, please see the article Direct numbers. This step doesn't apply to Spanish mobile numbers, which are always created as Direct Numbers.

  1. Once the number is configured as a direct number, select Assign eSIM license

    assign eSIM license

  2. Choose the license to assign to the user and confirm

    choose the license

You can return to the Numbers list to verify that the eSIM has been assigned successfully.

check the eSIM option from the numbers list

Step 3: Agent activates the eSIM on their device

Once the Admin completes the setup, the agent receives an email with a QR code and instructions for installing the eSIM on their device.

On iOS, iPhone

  1. Open Settings
  2. Go to Mobile Service
  3. Tap Add eSIM
  4. Scan the QR code from the email
  5. For Spain Mobile eSIMs: enter the PIN provided in the activation email when prompted. The same email also includes your PUK codes; keep them in case the PIN is entered incorrectly multiple times.
  6. Follow the on-screen steps to confirm the installation
Note: If prompted, confirm that you want Aircall to redirect you to iPhone Settings. This step is required to complete the eSIM installation.

On Android

  1. Scan the QR code from the email
  2. For Spain Mobile eSIMs: enter the PIN provided in the activation email when prompted. The same email also includes your PUK codes; keep them in case the PIN is entered incorrectly multiple times.
  3. Follow the on-screen instructions to complete the installation

Managing eSIM assignments

Recovering a deleted number with an eSIM

If a number with an active eSIM is deleted and then recovered, the eSIM configuration is reset. The Admin will need to reassign the eSIM license and the agent will need to reinstall the eSIM on their device following the same activation steps.

Reassigning an eSIM to a different user

If the user assigned to an eSIM number is changed, the existing eSIM is automatically cancelled and the Admin will need to assign a new eSIM to the number. The previous user receives an email confirming their eSIM has been removed, and the new user receives a new email with a QR code to install the eSIM on their device. The previous user's eSIM stops working immediately upon reassignment.

Resending a lost activation email

If an agent loses or deletes the original activation email, the Admin can resend the same QR code from the number's Integrations tab rather than reassigning the eSIM from scratch.

Changing devices

Moving an eSIM to a different device deactivates it on the current one. The agent receives a new email with a new QR code, PIN, and PAC code, and must install the eSIM on the new device using those.

Changing the data allowance

The eSIM license (0GB, 20GB, or 50GB) can be changed from the number's Integrations tab. No email is sent for this change, so confirm the update directly in the Aircall Dashboard rather than waiting for a notification.

IMPORTANT:
For Spanish mobile numbers, removing the eSIM deactivates the number entirely, not just the eSIM feature. To resume service, assign an eSIM license again; this issues a new QR code by email.