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

# Connect

> Connect with the Linked Account's Aircall account.

<Note>
  Aircall is an **API Key** based integration and does not require the setup of an app.
</Note>

### Required Credentials of a Linked Account

To successfully connect with the **Aircall** integration, a Linked Account or an end-user will need to provide the following to connect:

1. API ID
2. API Token

<Info>
  To understand how a Linked Account can get the above mentioned credentials, refer below.
</Info>

### Getting Credentials of Aircall

To acquire the required credentials and connect a Linked Account, please follow the steps mentioned below:

<img height="200" src="https://mintcdn.com/cobalt-55/USIhqTKu3QZXm8QM/images/Aircall/aircall_config.png?fit=max&auto=format&n=USIhqTKu3QZXm8QM&q=85&s=1c2b8597b8e819b021e3a339cfe9f7c3" alt="Connect a Linked Account" data-path="images/Aircall/aircall_config.png" />

1. Log in to your [Aircall account](https://dashboard.aircall.io/login).
2. Click on the `Integrations & API` in the side menu and click on `API Keys` tab.

<img height="200" src="https://mintcdn.com/cobalt-55/USIhqTKu3QZXm8QM/images/Aircall/aircall_navigation.png?fit=max&auto=format&n=USIhqTKu3QZXm8QM&q=85&s=8c1e55178028488c326c2637754c78e3" alt="Navigation in Aircall" data-path="images/Aircall/aircall_navigation.png" />

3. Click on `Generate an API key` and enter a `Key name`.
4. Copy the `API ID` and `API Token` displayed and click on `Confirm`.

<Info>
  Copy the API token as it won't be visible again.
</Info>

<img height="200" src="https://mintcdn.com/cobalt-55/USIhqTKu3QZXm8QM/images/Aircall/aircall_credentials.png?fit=max&auto=format&n=USIhqTKu3QZXm8QM&q=85&s=cf6ce9ca2defa4f59d70d5c126471364" alt="Getting Credentials" data-path="images/Aircall/aircall_credentials.png" />

The Linked Account or end-user now have all the credentials required to connect with Aircall.

#### Actions and triggers

In Refold, you can create orchestrations of your use-cases using Aircall actions and triggers. Following are the set of Aircall actions and triggers
supported by Refold.

<Tabs>
  <Tab title="Actions">
    <AccordionGroup>
      <Accordion title="Call">
        1. **Start Outbound Call** - Start an outbound call for a User from their Phone app. The User must be available, not on a call, and associated with the Number to be used for the call.
      </Accordion>

      <Accordion title="Contact">
        2. **Create Contact** - Create a new Contact that will be automatically shared across the company in Aircall.
        3. **Update Contact** - Update a shared Contact and get the updated Contact as the response in Aircall.
        4. **Delete Contact** - Delete a shared Contact from the Company in Aircall.
      </Accordion>

      <Accordion title="Others">
        5. **HTTP Request** - Make HTTP API calls to any Aircall documented REST APIs.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Triggers">
    1. **Contact Created** - Triggers when a new contact is created in Aircall.
    2. **Contact Updated** - Triggers when a contact is updated in Aircall.
    3. **Contact Deleted** - Triggers when a contact is deleted in Aircall.
    4. **Call Created** - Triggers when a call is created in Aircall.
    5. **Call Ringing on Agent** - Triggers when calls start ringing on Agents' Phone in Aircall.
    6. **Call Agent Declined** - Triggers when an Agent declines a call in Aircall.
    7. **Call Answered** - Triggers when a call is answered in Aircall.
    8. **Call Transferred** - Triggers when a call is transferred in Aircall.
    9. **Call Unsuccessful Transfer** - Triggers when a call is unsuccessfully transferred in Aircall.
    10. **Call Hungup** - Triggers when a new contact is created in Aircall.
    11. **Contact Created** - Triggers when a call is hungup in Aircall.
    12. **Call Ended** - Triggers when a call is ended in Aircall.
    13. **Call Voicemail Left** - Triggers when a voicemail is left in Aircall.
    14. **Call Commented** - Triggers when a call is commented in Aircall.
    15. **Call Tagged** - Triggers when a call is tagged in Aircall.
    16. **Call Untagged** - Triggers when a call is untagged in Aircall.
    17. **Call Assigned** - Triggers when a call is assigned in Aircall.
    18. **Call Archived** - Triggers when a call is archived in Aircall.
    19. **Call Hold** - Triggers when a call is put on hold in Aircall.
    20. **Call Unhold** - Triggers when a call is unhold in Aircall.
    21. **Call IVR Option Selected** - Triggers when ivr option is selected on a smartflow enabled number in Aircall.
    22. **Call Comm Assets Generated** - Triggers when communication assets for a call i.e. call recording or voicemail is generated in Aircall.
    23. **User Created** - Triggers when a new user is created in Aircall.
    24. **User Deleted** - Triggers when a user is delete in Aircall.
    25. **User Connected** - Triggers when a user is connected in Aircall.
    26. **User Disconnected** - Triggers when a user is disconnected in Aircall.
    27. **User Opened** - Triggers when users become available according to their working hours in Aircall.
    28. **User Closed** - Triggers when users become unavailable according to their working hours in Aircall.
    29. **User WUT Start** - Triggers when user start their wrap up time (WUT) work according to their setting in Aircall.
    30. **User WUT End** - Triggers when user finish their wrap up time (WUT) work according to their setting in Aircall.
    31. **Number Created** - Triggers when a number is created in Aircall.
    32. **Number Deleted** - Triggers when a number is deleted in Aircall.
    33. **Number Opened** - Triggers when a number opens according to its opening hours in Aircall.
    34. **Number Closed** - Triggers when a number closes according to its opening hours in Aircall.
  </Tab>
</Tabs>