Quickstart
From nothing configured to "my number rings my phone" in one sitting. Every step can also be done in the admin UI under ScaiDial; the API calls are shown so you can automate it.
Prerequisites#
- A ScaiGrid API key with
scaidial:trunks:manage,scaidial:extensions:manageandscaidial:dialplan:manage(tenant admins have all three). See permissions. - A SIP trunk from a carrier (or your own PBX): server name, username and password, and at least one phone number (DID) on it.
1 2 | |
1. Add the trunk#
1 2 3 4 5 6 7 8 9 10 11 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | |
ScaiDial sets the trunk up on the ScaiLabs SBC, which registers with your carrier. Two things to check:
sync_statuson the trunk becomessyncedwhen the configuration is in place (error+sync_last_errorotherwise; fix andPOST /trunks/{id}/resync).GET /trunks/{id}/registrationreports whether the carrier accepted the registration:{"state": "registered", "registrar": "sip.example-carrier.com", "next_attempt_at": "…"}.failedmeans the carrier rejected or didn't answer — usually the username or password.
Carriers that authenticate by source address ("sip_auth_mode": "ip_whitelist") need the SBC's addresses: GET /network-info returns them with the SIP ports and the RTP range.
Check the caller ID too: the trunk's carrier.preview.from is what the carrier will receive on outbound calls. If your carrier isn't recognised automatically, the trunk uses generic settings (E.164 numbers, caller ID in From); see carrier profiles to adjust them. IP-authenticated trunks also need the carrier's source addresses in carrier_overrides.allowed_ips.
2. Create an extension and a dialplan#
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | |
If nobody answers within the ring timeout, the call goes to the extension's voicemail.
3. Point your number at the dialplan#
1 2 3 4 5 | |
Call the number from your mobile. The call appears on ScaiDial → Active Calls as ringing, then active when answered; afterwards it is in Call History.
4. Add a desk phone or softphone#
1 2 3 4 5 6 7 | |
The response holds the phone's login: domain (your tenant's <label>.sip.scailabs.ai), username (the extension number), password and the transports. Enter them in the phone — TLS on port 5061 is recommended. Once registered, the phone shows up under registrations, can call other extensions by number and outside numbers in national or international format, and rings when its extension is called. See desk phones and softphones.
Next steps#
- IVR menu: "press 1 for sales, 2 for support" — see dialplans.
- Bots: an extension of type
botputs a ScaiBot voice agent on a number. - After-hours: a
time_windowrule plus an announcement or voicemail. - Forward to a mobile: an
externalextension with"target_ref": "+31612345678". - Voicemail transcripts and summaries: turn them on with
PATCH /policy{"voicemail_transcript_enabled": true}. - Music on hold: upload your own on ScaiDial → Music on hold (music on hold).