communication
Aircall CLI for Headless Automation
Use the Aircall CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
8 functions 6 read 2 write Manual OAuth token auth
Aircall CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Aircall CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Aircall CLI for Headless Automation
kosmokrator integrations:configure aircall --set access_token="$AIRCALL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call aircall.aircall_list_calls '{"per_page":1,"page":1,"order":"example_order","from":"example_from","to":"example_to","direction":"example_direction","user_id":1,"number_id":1}' --jsonDiscovery Before Execution
Agents and scripts can inspect Aircall docs and schemas before choosing a function.
kosmo integrations:docs aircall --json
kosmo integrations:docs aircall.aircall_list_calls --json
kosmo integrations:schema aircall.aircall_list_calls --json
kosmo integrations:search "Aircall" --json
kosmo integrations:list --jsonUseful Aircall CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
aircall.aircall_list_calls | Read | per_page, page, order, from, to, direction, user_id, number_id, tags | List calls from Aircall with optional filters. Supports filtering by date range, direction (inbound/outbound), user ID, phone number, and tags. Returns paginated call records. |
aircall.aircall_get_call | Read | call_id | Retrieve detailed information about a specific call in Aircall by its ID. Returns call details including duration, direction, status, recording, and contact information. |
aircall.aircall_list_contacts | Read | per_page, page, order, q | List contacts from Aircall with optional search and pagination. Search by name, phone number, or email. Returns contact details including phone numbers and emails. |
aircall.aircall_create_contact | Write | first_name, last_name, company_name, information, phone_numbers, emails | Create a new contact in Aircall. Provide at least a first name or last name, and one phone number or email. |
aircall.aircall_update_contact | Write | contact_id, first_name, last_name, company_name, information, phone_numbers, emails | Update an existing contact in Aircall. Provide the contact ID and the fields to update. |
aircall.aircall_list_users | Read | none | List all users in the Aircall account. Returns user details including name, email, availability, and assigned phone numbers. |
aircall.aircall_list_numbers | Read | none | List all phone numbers in the Aircall account. Returns number details including the phone number, country, type, and assigned users. |
aircall.aircall_get_current_user | Read | none | Retrieve the currently authenticated Aircall user. Returns user details including name, email, and availability status. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.