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. |
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.- Log in to your Aircall dashboard and navigate to Integrations → API Keys.
- Click Create a new OAuth app.
- Configure your OAuth application:
- Add the redirect URI: https://api.runalloy.com/api/strategy/connector/aircall/callback
- The
public_api
scope is automatically granted and provides access to all API resources
- Copy your Client ID and Client Secret.
- Enter your Client ID and Client Secret into Alloy Automation.
Option 2: Bearer Token (API Key)
- Log in to your Aircall dashboard and go to Integrations → API Keys.
- Click Create a new API Key.
- Copy the generated API key.
- 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/authorizeScopes
Aircall uses a simplified scope model where thepublic_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-referencesUse 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.