# astraonlineweb/astracalls architecture

> Architecture diagram of the GitHub repository astraonlineweb/astracalls, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/astraonlineweb/astracalls
- Repository: https://github.com/astraonlineweb/astracalls

## Overview

AstraCalls is a browser-operated WhatsApp communications service: operators pair accounts, then place or receive calls and manage messaging, campaigns, and integrations. The documented call path spans the React console, session/call APIs, Go session runtime, native VoIP signaling and media, and WhatsApp; SIP, group calls, messaging, webhooks, and Chatwoot are distinct product branches. Edges are limited to explicit README statements and shown caller references; several server subsystems are represented by exact directories because their implementation files were not sampled.

Main entry points: [`cmd/server/session.go`](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/session.go) (WhatsApp session), [`internal/voip/call/callmanager.go`](https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/callmanager.go) (Call manager), [`client/src/App.tsx`](https://github.com/astraonlineweb/astracalls/blob/main/client/src/App.tsx) (Web console), [`cmd/server/sessionmanager.go`](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/sessionmanager.go) (Session manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Operator console"]
  node_ui["Web console<br/>[App.tsx]"]
  node_pairing["Account pairing<br/>[SessionPairing.tsx]"]
  node_call_ui["Call controls"]
  node_call_hooks["Call actions"]
  node_client_api["API and transport<br/>[api.ts]"]
end

subgraph group_runtime["Session and API runtime"]
  node_server_api["HTTP and events<br/>[httpapi.go]"]
  node_sessions["Session manager<br/>[sessionmanager.go]"]
  node_session_runtime["WhatsApp session<br/>[session.go]"]
  node_session_state[("Session persistence<br/>[sessionstore.go]")]
end

subgraph group_voip["WhatsApp VoIP"]
  node_call_manager["Call manager<br/>[callmanager.go]"]
  node_call_signaling["Call signaling"]
  node_audio_media["Audio media"]
  node_video_media["Video pipeline<br/>[pipeline.go]"]
  node_voip_transport["Relay transport"]
  node_group_calls["Group calling<br/>[groupcall.go]"]
end

subgraph group_communications["Messaging and campaigns"]
  node_messaging["Messaging APIs<br/>[messaging.go]"]
  node_campaigns["Campaigns<br/>[blast.go]"]
end

subgraph group_integrations["External integrations"]
  node_sip_gateway["SIP gateway<br/>[sip_gateway.go]"]
  node_sip_connector["SIP connector<br/>[main.go]"]
  node_webhooks["Webhook delivery<br/>[webhookdelivery.go]"]
  node_chatwoot["Chatwoot integration<br/>[chatwoot.go]"]
end

node_operator(("Operator"))
node_whatsapp{{"WhatsApp network"}}
node_chatwoot_user(("Chatwoot"))
node_pbx(("PBX / SIP peer"))
node_api_user(("API client"))

node_operator -->|"uses"| node_ui
node_ui -->|"pairs account"| node_pairing
node_ui -->|"opens calls"| node_call_ui
node_call_ui -.->|"invokes actions"| node_call_hooks
node_call_hooks -.->|"calls API"| node_client_api
node_client_api -->|"sends requests"| node_server_api
node_api_user -->|"calls API"| node_server_api
node_server_api -.->|"routes sessions"| node_sessions
node_sessions -->|"creates session"| node_session_runtime
node_sessions -.->|"loads state"| node_session_state
node_session_runtime -.->|"runs calls"| node_call_manager
node_call_manager -->|"handles signaling"| node_call_signaling
node_call_manager -->|"processes audio"| node_audio_media
node_call_manager -->|"creates pipeline"| node_video_media
node_audio_media -->|"sends relay media"| node_voip_transport
node_video_media -->|"sends video"| node_voip_transport
node_call_signaling -->|"exchanges stanzas"| node_whatsapp
node_call_manager -.->|"supports group calls"| node_group_calls
node_session_runtime -.->|"offers SIP"| node_sip_gateway
node_sip_gateway -->|"connects SIP"| node_pbx
node_sip_connector -->|"connects SIP"| node_pbx
node_session_runtime -.->|"provides messaging"| node_messaging
node_session_runtime -.->|"runs campaigns"| node_campaigns
node_session_runtime -.->|"emits events"| node_webhooks
node_session_runtime -.->|"integrates"| node_chatwoot
node_chatwoot -->|"syncs conversations"| node_chatwoot_user

click node_ui "https://github.com/astraonlineweb/astracalls/blob/main/client/src/App.tsx"
click node_pairing "https://github.com/astraonlineweb/astracalls/blob/main/client/src/components/domain/session/SessionPairing.tsx"
click node_call_ui "https://github.com/astraonlineweb/astracalls/tree/main/client/src/components/domain/call"
click node_call_hooks "https://github.com/astraonlineweb/astracalls/tree/main/client/src/hooks"
click node_client_api "https://github.com/astraonlineweb/astracalls/blob/main/client/src/lib/api.ts"
click node_server_api "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/httpapi.go"
click node_sessions "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/sessionmanager.go"
click node_session_runtime "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/session.go"
click node_session_state "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/sessionstore.go"
click node_call_manager "https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/callmanager.go"
click node_call_signaling "https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/callmanager_signaling.go"
click node_audio_media "https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/callmanager_media.go"
click node_video_media "https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/video/pipeline.go"
click node_voip_transport "https://github.com/astraonlineweb/astracalls/tree/main/internal/voip/transport"
click node_group_calls "https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/groupcall.go"
click node_sip_gateway "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/sip_gateway.go"
click node_sip_connector "https://github.com/astraonlineweb/astracalls/blob/main/cmd/sipconnector/main.go"
click node_messaging "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/messaging.go"
click node_campaigns "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/blast.go"
click node_webhooks "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/webhookdelivery.go"
click node_chatwoot "https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/chatwoot.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_pairing,node_call_ui,node_call_hooks,node_client_api,node_api_user toneBlue
class node_server_api,node_sessions,node_session_runtime,node_session_state toneAmber
class node_call_manager,node_call_signaling,node_audio_media,node_video_media,node_voip_transport,node_group_calls toneMint
class node_messaging,node_campaigns toneRose
class node_sip_gateway,node_sip_connector,node_webhooks,node_chatwoot,node_operator,node_whatsapp,node_chatwoot_user,node_pbx toneIndigo
```

## Components

### Operator console

- [Web console](https://github.com/astraonlineweb/astracalls/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [Account pairing](https://github.com/astraonlineweb/astracalls/blob/main/client/src/components/domain/session/SessionPairing.tsx): `client/src/components/domain/session/SessionPairing.tsx`
- [Call controls](https://github.com/astraonlineweb/astracalls/tree/main/client/src/components/domain/call): `client/src/components/domain/call`
- [Call actions](https://github.com/astraonlineweb/astracalls/tree/main/client/src/hooks): `client/src/hooks`
- [API and transport](https://github.com/astraonlineweb/astracalls/blob/main/client/src/lib/api.ts): `client/src/lib/api.ts`

### Session and API runtime

- [HTTP and events](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/httpapi.go): `cmd/server/httpapi.go`
- [Session manager](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/sessionmanager.go): `cmd/server/sessionmanager.go`
- [WhatsApp session](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/session.go): `cmd/server/session.go`
- [Session persistence](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/sessionstore.go): `cmd/server/sessionstore.go`

### WhatsApp VoIP

- [Call manager](https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/callmanager.go): `internal/voip/call/callmanager.go`
- [Call signaling](https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/callmanager_signaling.go): `internal/voip/call/callmanager_signaling.go`
- [Audio media](https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/callmanager_media.go): `internal/voip/call/callmanager_media.go`
- [Video pipeline](https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/video/pipeline.go): `internal/voip/call/video/pipeline.go`
- [Relay transport](https://github.com/astraonlineweb/astracalls/tree/main/internal/voip/transport): `internal/voip/transport`
- [Group calling](https://github.com/astraonlineweb/astracalls/blob/main/internal/voip/call/groupcall.go): `internal/voip/call/groupcall.go`

### Messaging and campaigns

- [Messaging APIs](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/messaging.go): `cmd/server/messaging.go`
- [Campaigns](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/blast.go): `cmd/server/blast.go`

### External integrations

- [SIP gateway](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/sip_gateway.go): `cmd/server/sip_gateway.go`
- [SIP connector](https://github.com/astraonlineweb/astracalls/blob/main/cmd/sipconnector/main.go): `cmd/sipconnector/main.go`
- [Webhook delivery](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/webhookdelivery.go): `cmd/server/webhookdelivery.go`
- [Chatwoot integration](https://github.com/astraonlineweb/astracalls/blob/main/cmd/server/chatwoot.go): `cmd/server/chatwoot.go`

### Other components

- **Operator**
- **WhatsApp network**
- **Chatwoot**
- **PBX / SIP peer**
- **API client**

## Connections

- Operator → Web console: uses (evidence: `README.md`)
- Web console → Account pairing: pairs account (evidence: `client/src/App.tsx`)
- Web console → Call controls: opens calls (evidence: `client/src/App.tsx`)
- Call controls → Call actions: invokes actions
- Call actions → API and transport: calls API
- API and transport → HTTP and events: sends requests (evidence: `README.md`)
- API client → HTTP and events: calls API (evidence: `README.md`)
- HTTP and events → Session manager: routes sessions
- Session manager → WhatsApp session: creates session (evidence: `cmd/server/sessionmanager.go`)
- Session manager → Session persistence: loads state
- WhatsApp session → Call manager: runs calls
- Call manager → Call signaling: handles signaling (evidence: `internal/voip/call/callmanager.go`)
- Call manager → Audio media: processes audio (evidence: `internal/voip/call/callmanager.go`)
- Call manager → Video pipeline: creates pipeline (evidence: `internal/voip/call/callmanager.go`)
- Audio media → Relay transport: sends relay media (evidence: `internal/voip/call/callmanager_media.go`)
- Video pipeline → Relay transport: sends video (evidence: `internal/voip/call/video/pipeline.go`)
- Call signaling → WhatsApp network: exchanges stanzas (evidence: `internal/voip/call/callmanager_signaling.go`)
- Call manager → Group calling: supports group calls
- WhatsApp session → SIP gateway: offers SIP
- SIP gateway → PBX / SIP peer: connects SIP (evidence: `README.md`)
- SIP connector → PBX / SIP peer: connects SIP (evidence: `cmd/sipconnector/main.go`)
- WhatsApp session → Messaging APIs: provides messaging
- WhatsApp session → Campaigns: runs campaigns
- WhatsApp session → Webhook delivery: emits events
- WhatsApp session → Chatwoot integration: integrates
- Chatwoot integration → Chatwoot: syncs conversations (evidence: `README.md`)
