VoIP / PBX Integration
Overview
Nexus integrates with Issabel PBX (Asterisk-based) for voice calling. Integration is mediated by n8n workflows that bridge PBX events to Nexus Edge Functions.
Capabilities
- Click-to-call from contact records.
- Real-time active call monitoring.
- CDR (Call Detail Record) synchronization.
- Extension management (user-to-extension mapping).
- Call analytics and reporting.
Edge Functions
| Function | Direction | Purpose |
|---|---|---|
call-initiate | Outbound | Triggers an outbound call via PBX |
call-start | Inbound | Handles call start events |
pbx-cdr | Inbound | Receives individual CDR records |
pbx-cdr-sync | Inbound | Bulk CDR synchronization |
pbx-extensions | Config | Manages extension data |
pbx-hook | Inbound | General PBX event webhook |
Architecture
Nexus UI → call-initiate → n8n → Issabel PBX → Phone call
PBX CDR → n8n → pbx-cdr-sync → Nexus DB (call_logs)
Common troubleshooting
| Issue | Resolution |
|---|---|
| Click-to-call not working | Check PBX API URL and credentials. Verify the agent's extension is mapped. |
| CDRs delayed | Check n8n workflow execution. CDR sync may batch records. |
| Extension not found | Map the user's extension in Settings → PBX → Extensions. |