Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iru.com/llms.txt

Use this file to discover all available pages before exploring further.

​
About Aircall

Aircall is a cloud-based business phone system and call-center platform. The Aircall source pulls call, user, and team activity into Iru so you can attach evidence to compliance frameworks. Authentication uses HTTP Basic against the Aircall Public API (api_id as username, api_token as password).

​
How it works

DetailValue
CategoryCommunications
AuthenticationHTTP Basic (Username = api_id, Password = api_token)
Vendor planAny paid Aircall plan (API access included)
Official references: Basic authentication, API references.

​
Prerequisites

  • Admin or Owner on the Aircall account (standard users cannot create API keys).
  • About 5 minutes for setup.
  • HTTPS for Aircall API traffic.
  • Browser pop-ups allowed so the connector wizard can open.

​
Connect Aircall to Iru

​
Aircall

1

Create an Aircall API key

Sign in to the Aircall Dashboard as an Admin or Owner.Open Integrations & API in the left sidebar. Open the Aircall API tile or the API Keys tab. Select Add a new API Key (the control may read Generate an API Key). Name the key (for example Iru Compliance) and confirm.Aircall displays api_id and api_token. Use api_id as the Basic Auth Username and api_token as the Password when you connect in Iru. api_token is shown only once. If you lose it, delete the key in Aircall and generate a new one.

​
Iru Compliance

1

Open Sources

In Iru Compliance, on the left navigation bar, expand Compliance and select Sources.
Left navigation: Compliance expanded, Sources selected
2

Turn on Aircall

Find Aircall (set Category to Communications or use Search by name or description). On the Aircall card, turn on the toggle. A new browser tab may open for the wizard.
3

Enter Basic authentication

On Enter Basic Authentication, put api_id in Username and api_token in Password. Select Submit Credentials.
4

Complete the wizard and confirm Active

Finish any remaining wizard prompts until the Aircall card shows Active. Iru begins pulling data after the source is Active.

​
Considerations

  • Account-wide keys: API keys apply to the account, not a single user. The integration can keep working if the person who created the key leaves, unless your team rotates or deletes the key in Aircall.
  • Rate limits: Aircall’s Public API default is 60 requests per minute. Iru applies backoff when limits are hit. Unusually frequent manual evidence refreshes could still trigger 429 responses. See troubleshooting.
  • Access mode: Iru uses this connection for read-oriented compliance evidence. The api_token still grants the access level Aircall assigns to that key. Store and rotate it like a secret.

​
Troubleshooting

Check pop-up blocker settings for the Iru site and try again.
The api_token may be wrong, or the key was deleted in Aircall. Create a new API key in Aircall and submit the new api_id / api_token in Iru.
You hit Aircall’s rate limit (60 requests per minute by default). Iru backs off automatically. If 429 persists, contact Aircall support about a higher limit.
Only Admin or Owner can create keys. Ask an Aircall administrator to create the key, or have your role updated.

​
See also