aircall

Attio app integrating with Aircall — a cloud phone and call-center platform.

What it does

Place calls and manage Aircall telephony from inside Attio. Click-to-call people and companies from record pages, add phone numbers to dialer campaigns in bulk, send SMS messages, and trigger Attio workflows from inbound Aircall activity. Call and message activity is logged back to Attio as notes, and calls as Attio activities.

Features

• Record actions — click-to-call a person or company directly from an Attio record page
• Bulk record action — add the phone numbers of multiple records to an Aircall dialer campaign at once
• Workflow blocks — add numbers to a dialer campaign and send SMS messages as workflow steps
• Workflow triggers — start workflows when an Aircall call ends or an inbound message is received
• Activities — ended calls are logged as an aircall_calls activity on the people with the counterparty's number
• Webhooks — Aircall webhooks are registered automatically on connect and removed on disconnect

Setup

pnpm install

Development

pnpm run dev

Commands

Command	Description
pnpm run dev	Start dev server
pnpm run build	Build + type-check
pnpm run lint	Run ESLint
pnpm run lint:fix	Run ESLint with auto-fix
pnpm run format	Format with Prettier
pnpm run format:check	Check formatting
pnpm run test	Run tests
pnpm run knip	Check for dead code

Source folder structure

Path	Description
src/app/extensions/	Record actions and the bulk action, one folder per extension.
src/aircall-api/	Aircall REST API client, endpoints, Zod schemas, auth/url helpers, error mapping.
src/attio/rest/	Attio REST API client for activities.
src/activities/	Attio activity definitions, their setup on connect, and the call activity write.
src/app/blocks/	Workflow step and trigger blocks (one folder per block).
src/app/webhooks/	Inbound Aircall webhook handler.
src/app/events/	Connection lifecycle handlers that register/deregister the Aircall webhook.
src/server/	Server functions that list Aircall numbers and users for configurators.
src/queries/	GraphQL queries for reading Attio record phone numbers / current user.
src/utils/	Shared helpers (logger).
src/assets/	App icon and static assets.

See AGENTS.md for full SDK usage notes and coding guidelines.