Salesforce call logging fields

Each call made or received with Aircall is logged into Salesforce based on your integration settings. Calls are logged as Salesforce Task records and populated with call details in specific fields. The Task is created either when the call is answered or, if the call is not answered, when the call ends.

Important: If your Salesforce integration is configured to log to Only Aircall Log Object, call data is logged exclusively to the Aircall Log object. Task-based fields and behaviors described below apply only when logging is set to Both Task and Aircall Log Object.

For more information about call logging in Salesforce, please see our article Logging calls in Salesforce.

How calls are logged to Tasks

When Task logging is enabled in your Salesforce v3 integration, Aircall uses the logging setting configured in the Aircall Dashboard:

Both Task and Aircall Log object (default for existing integrations)

• Aircall creates a Task with key call information.

• Aircall also creates an Aircall Log record that contains the full set of call or message details.

• The Task can include a lookup field to the related Aircall Log record so users can open the enriched log from the Task.

Only Aircall Log object

• Call data is logged exclusively to the Aircall Log object.

• Tasks are not used for new logs in this configuration.

• Reporting and automation should be based on the Aircall Log object.

Important: Logging to Only Task is not available. The Salesforce Task object has a limited number of custom fields and does not support all of Aircall’s enriched logging. The integration always writes to the Aircall Log object when logging is enabled.

Regardless of the logging option, any Task that is created by the integration is populated according to the field behavior described in the sections below.

Note: Make sure the Type field field level security is set to Visible on the Task object in Salesforce.

What appears in logged calls

Type and TaskSubtype

The Type and TaskSubtype fields are set to Call for calls logged by Aircall.

Important: Make sure the Type field field-level security is set to Visible on the Task object in Salesforce. If it is not visible, calls will not be logged. For more information, please see Salesforce configuration: Type field

Subject

The Subject field of the Task is generated using the logic below.

Note: The Record Name is the name of the Contact, Account, or Lead the Task is assigned to in Salesforce.

CallDisposition (Call Result)

The CallDisposition field, displayed as Call Result in Salesforce, follows this structure:

• aircall (indicates the call occurred on Aircall)

• Tag or tags applied to the call, separated by commas

• Call direction, inbound or outbound

• Call status, answered_call or unanswered_call

• Aircall number in E164 format without the +

• Missed call reason, when applicable:

  • out_of_opening_hours

  • no_available_agent

  • abandoned_in_ivr

  • abandoned_in_classic

  • short_abandoned

  • agents_did_not_answer

Example:

['General_Inquiries', 'aircall', 'inbound', 'answered_call', '18882406923', 'no_available_agent']

CallType (Call Type)

The CallType field, shown as Call Type in Salesforce, is set from a Salesforce picklist and is either Inbound or Outbound.

ActivityDate (Due Date)

The ActivityDate field, displayed as Due Date, is populated with the date the call was created in Aircall. This corresponds to when an outbound call was placed or when an inbound call was first received. The date is stored in UTC.

WhoId (Name)

The WhoId field, shown as Name, contains the Salesforce ID of the Contact or Lead associated with the call.
If the call is assigned directly to an Account, this field is left blank.
The Contact or Lead name appears in the Name field on the Task.

WhatId (Relates To)

The WhatId field, shown as Relates To, contains the Salesforce ID of the related Account, Case, or Opportunity. The record name is displayed in the Relates To field.

When multiple objects share the same phone number, the following priority order is used:

1. Contact

2. Lead

3. Account

4. Person Account

If multiple records of the same object type exist, the call is logged to the first record returned by Salesforce, which is typically the most recently updated.

If multiple Cases or Opportunities are associated with a Contact, the call is logged to the first one returned by Salesforce.

Note: Aircall can automatically create a new Case if one does not already exist. Creating new Opportunities is not supported.

OwnerId (Assigned To)

The OwnerId field, displayed as Assigned To, is the Salesforce user who owns the Task. Ownership is determined using the logic below.

Answered inbound calls and all outbound calls

1. If the Aircall user and Salesforce user share the same email address and the Salesforce user has existed for at least one day, that user becomes the owner.

2. If emails do not match, the Task is assigned to the owner of the related Contact, Account, or Lead.

3. If no valid or active owner exists, the Task is assigned based on the When a call is not matched to a Salesforce User, assign it to setting.

4. If no user is selected in that setting, the Task is owned by the Salesforce admin who installed the integration.

Missed inbound calls

1. The Task is assigned to the owner of the related Contact, Account, or Lead.

2. If no valid or active owner exists, the fallback assignment setting applies.

3. If no user is defined, the admin who installed the integration becomes the owner.

Important: If no Contact, Account, or Lead exists with a validly formatted number and Aircall creates a new record, the new record is owned by the integration admin. If record creation is disabled, WhoId, WhatId, and OwnerId are not populated. For more information, please see What number format you can use to log calls.

Waiting time

The aircall__Waiting_Time__c field, shown as Waiting Time, contains the number of seconds between an inbound call being received and answered. For outbound calls, this value is 0.

Call duration

The Call Duration field stores the number of seconds spent actively talking on the call. Waiting time for inbound calls is excluded. Missed calls, inbound or outbound, have a duration of 0.

Answered by

The aircall__Answered_by__c field, displayed as Answered by, contains the name of the Aircall user who answered the call.

Aircall number

The aircall__Phone_number__c field, shown as Aircall Number, contains the Aircall number used for the call in E164 format without the +.

Country

The aircall__Country__c field, shown as Country, contains the country name associated with the Aircall number.

Call recording

The aircall_Call_Recording_c field, displayed as Call Recording, contains a link to the call recording.

Status

The Status field is set to Completed or In progress based on your integration settings.

• Completed Tasks appear under Past Activities

• In progress Tasks appear under Next Steps

Note: If integration settings are configured to do nothing for a specific call type, no Task is created in Salesforce.

Description (Comments)

The Description field, shown as Comments, includes links to recordings and notes.

• Missed call with voicemail:
  Find voicemail here: [link to the call recording]

• Call with standard recording:
  Find recording here: [link to the call recording]

Notes added in the Aircall app also appear here, up to 32,000 characters, using this format:

[Aircall agent name] added a new comment:

[comment content]

Notes added later by another agent or after a transfer are appended in the same field.

Transferred to (aircall_Transferred_to_c)

If a call is transferred, that information is entered into the custom field aircall_Transferred_to_c, visible as Transferred to in Salesforce.

• When a call is transferred from User A to User B and User B answers, Answered by is updated to User B.
• If User B does not answer, Answered by remains User A.
• If User B answers, only User B tags are logged and User A tags are overwritten.
• If the call is transferred to an external number instead of an Aircall user, the transfer is treated as a separate call and does not update these fields.

Timezone

The Timezone field contains the timezone configured for the Aircall number used in the call.

Hour of the day

The Hour of the day field stores the hour during which the call was made or received.

Connection status

For inbound calls, the Connection status field is populated as Connected or Not connected. The Has connected checkbox is selected only when the status is Connected.

Aircall Log object (ALO) and AI insights

• The previous Aircall AI object (aircall__Aircall_AI__c) is relabeled as Aircall Log.
• The Aircall Log object is used to store all call and SMS data, including rich text fields and AI insights, and to overcome Task field limits.

When the Aircall Log feature is available:

• An Aircall Log record is created for each logged interaction, according to your logging setting (Both Task and ALO, or Only ALO).

• If Aircall AI is enabled, that record includes AI generated call summaries and key topics as rich text fields.

• When logging to Both Task and ALO, the Task contains a lookup field labeled Aircall Log that points to the related Aircall Log record, so users can open the full log from the Task.

Note: If the Aircall AI field is not visible on the Task, ask your Salesforce admin to add it to the Task page layout in Salesforce Setup.

For detailed behavior, field coverage, and reporting guidance, see the dedicated Aircall Log object (ALO) article.

Additional notes

These points apply when Task logging is enabled:

• Task Priority is always Normal unless edited manually.

• Created by and Updated by always reference the Salesforce admin who installed the integration.

• Updating tags or comments in Aircall updates the Salesforce Task.

• RecordTypes cannot be selected by the integration.

• If the integration admin owns the Contact, Lead, or Account, ownership updates to the next user who handles the record.

• When Person Accounts are disabled, Leads require a Company Name. Aircall uses Unknown Company.

For more information on enabling Aircall custom fields in Salesforce, refer to How to make custom fields visible in Salesforce.