> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aircall

> Integration details and setup guide for the Aircall connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                                                                      |
| ----------------------------------- | ---------------------------------------------------------------------------- |
| **Authentication**                  | OAuth 2.0 (Authorization Code with refresh tokens) or Bearer Token (API Key) |
| **Two-Way Sync**                    | Yes                                                                          |
| **Events Supported**                | Yes (Webhooks)                                                               |
| **Realtime**                        | Yes                                                                          |
| **Supports Rate Limiting**          | Yes (100 requests per minute per account)                                    |
| **Authentication Scopes Supported** | `public_api` (access to public API)                                          |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **Aircall**:

* **Calls** (Call records and details)
* **Users** (Team members)
* **Numbers** (Phone numbers)
* **Contacts**
* **Tags**
* **Teams**
* **Voicemails**
* **Comments** (Call comments)
* **Webhooks**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                       |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Yes. Aircall offers a 7-day free trial. Sign up at [https://aircall.io](https://aircall.io). |
| **Requires requires paid sandbox**                 | No paid sandbox required. You can test with your trial account.                              |
| **Requires partnership to obtain authentication?** | No. You can obtain API credentials directly from your Aircall dashboard.                     |

***

### Authentication (OAuth 2.0 or Bearer Token)

#### Option 1: OAuth 2.0 (Recommended for user-facing integrations)

For customers who want to completely whitelabel their OAuth experience, you can provide your own developer keys instead of using Alloy Automation's.

1. Log in to your **Aircall dashboard** and navigate to **Integrations** → **API Keys**.
2. Click **Create a new OAuth app**.
3. Configure your OAuth application:
   * Add the redirect URI: [https://api.runalloy.com/api/strategy/connector/aircall/callback](https://api.runalloy.com/api/strategy/connector/aircall/callback)
   * The `public_api` scope is automatically granted and provides access to all API resources
4. Copy your **Client ID** and **Client Secret**.
5. Enter your **Client ID** and **Client Secret** into Alloy Automation.

#### Option 2: Bearer Token (API Key)

1. Log in to your **Aircall dashboard** and go to **Integrations** → **API Keys**.
2. Click **Create a new API Key**.
3. Copy the generated API key.
4. Enter the API key into Alloy Automation as a Bearer token.

#### OAuth Authorization URL

The authorization URL for Aircall is: [https://dashboard-v2.aircall.io/oauth/authorize](https://dashboard-v2.aircall.io/oauth/authorize)

#### Scopes

Aircall uses a simplified scope model where the `public_api` scope provides access to all API resources. Access is automatically limited by the user's permissions within the Aircall account.

#### API Documentation

For detailed API documentation, visit: [https://developer.aircall.io/api-references](https://developer.aircall.io/api-references)

***

## Use Cases

### 1) Call logging and CRM synchronization

Automatically sync call records, recordings, and metadata from Aircall into your CRM, ensuring sales and support teams have complete visibility into customer conversations without manual logging.

### 2) Contact enrichment and management

Synchronize contacts between Aircall and your customer database, automatically updating contact information, tags, and call history across platforms to maintain data consistency.

### 3) Real-time call notifications

Use Aircall webhooks to trigger real-time notifications or workflows when calls are answered, missed, or completed—such as creating support tickets, sending follow-up emails, or logging activities in project management tools.

### 4) Performance analytics and reporting

Pull call data, user metrics, and team statistics from Aircall into your business intelligence platform to analyze call volume, response times, team performance, and customer engagement patterns.

### 5) Automated voicemail transcription workflows

Monitor new voicemails via webhooks and trigger custom workflows like transcription services, sentiment analysis, or automatic ticket creation based on voicemail content and urgency.

***

## API Gotchas

* ⚠️ **Rate limiting:** Aircall enforces a rate limit of 100 requests per minute per account. Exceeding this limit will result in 429 responses. Implement request throttling and exponential backoff.
* ⚠️ **Webhook payload size:** Aircall webhooks include minimal data in the payload. You'll typically need to make follow-up API calls to fetch complete call or contact details after receiving a webhook event.
* ⚠️ **Call recording URLs:** Call recording URLs are temporary and expire after a certain period. Download and store recordings in your own system if long-term access is required.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.