Set up Cape for your team
This page takes someone who can manage Cape from a fresh install to a centre that takes calls: the phone provider and numbers, what callers hear, the queue and hours, people, recording, calling out and AI.
Before you start
- You can manage Cape. On a server where Foxden Admin is connected, the Owner gives you that level in Admin. On a server where Cape runs alone, the first account is made with the setup link that whoever runs the server holds; see Running Cape.
- You have an account with Twilio or Telnyx. Cape uses Twilio unless whoever runs the server switches it to Telnyx; it uses one, never both. Calls are billed to that account.
Follow the checklist
Open Settings. The first tab, Setup, is a checklist titled Set up your call centre: Phone provider, Number, brand and greeting, Queue, Invite your agents, Hours and holidays, Recording, Outbound calling, AI transcripts and summaries, Sign-in, then Test call. Work through it in order. "Configured" means the settings are saved; only a real call proves the whole path.
Connect the phone provider
Telnyx:
- Open Settings, then Provider.
- Paste the API key, the Public key and the Account ID from Telnyx Mission Control. The page says where each one is.
- Select Check account. Cape checks the key and the account.
- Leave the TeXML app and the agents' connection on the choice where Cape creates its own after you save, or pick existing ones.
- Select Save account.
- Have Cape restarted: the account is used only after a restart. With Admin connected, the Owner restarts Cape from Server › Products › Cape in Admin; otherwise ask whoever runs the server.
Cape only changes Telnyx resources it created. If one drifts, select Repair under What Cape keeps on Telnyx.
Twilio:
- Open Settings, then Provider. Under Connect Twilio, the page lists what to make in your Twilio account (an API key, a Softphone app and a Headset check app, with the exact addresses to enter) and the six values Cape needs.
- In the Twilio Console, make the API key and the two apps.
- Set the six values on the server. With Admin connected, the Owner sets them in Admin under Server › Products › Cape and presses Restart. Otherwise whoever runs the server sets them; see Running Cape.
- In the Twilio Console, under Voice geo permissions, allow every country you will call. Twilio refuses calls to any other.
Add numbers
- Telnyx: under Buy a number on Provider, search by Country and Area code, select Buy…, then type the number to confirm. The number is paid from your Telnyx balance and goes straight onto Cape. Numbers in a country that needs identity documents, South Africa among them, are ordered in Mission Control; select Attach to Cape once they appear under Numbers on this account.
- Twilio: buy the number in the Twilio Console, then select Attach to Cape (or Move to Cape… for a number already in use) under Numbers on this account.
Set what callers hear
- Open Settings, then Numbers, and choose a number.
- Set the Brand label and the Agent greeting. The person answering sees both on the offer card, and Offer card preview shows it as you type.
- Choose the Menu template: Straight to queue, Open / closed by hours, or 1–5 menu, a menu of up to five keys, each leading to the queue or to voicemail.
- Under What callers hear, set the messages: each is read by the provider's voice, by an AI voice through Admin, or is a recording you upload (WAV or MP3, up to 5 MB and 60 seconds).
- Leave Record calls on this number and Send calls to AI on, or switch them off for this number.
Whatever the template, callers who ring outside your hours, or while nobody is signed in, go to voicemail.
Set the queue and hours
Under Queue:
- Maximum wait (seconds): 30 to 600 (120 out of the box), then the caller goes to voicemail.
- Answered within (seconds): the target for the service level in reports (20 out of the box).
- Short abandon (seconds): callers who hang up sooner do not count as abandoned (5 out of the box).
- Missed calls in a row: how many ringing offers someone may miss before Cape sets them to Away (2 out of the box).
- Longest wrap-up (seconds): 30 to 1,800 (300 out of the box).
- Longest message (seconds): the longest voicemail, 30 to 600 (120 out of the box).
Under Hours:
- Set the Time zone.
- Choose the Public holidays the line closes on.
- Set the Weekly schedule. A day without an interval is closed.
- Save. Until you save hours, calls in are answered at any time and no call goes out.
- Add any date that does not follow the week under Add dated override.
Invite people
With Admin connected and managing Cape's people, people and their levels are set in Admin; see Give people access to the apps. Otherwise:
- Open Settings, then People.
- Under Invite user, enter the Invite email.
- Choose the Invite role: Can use (takes calls), Team lead (also watches the live team) or Can manage (also changes these settings).
- Select Create invite.
- Copy the link and send it yourself. Cape sends no email. The link is shown once and works for 7 days; New invite link on the person's row makes another.
Set recording
Under Recording: Record calls, Tell inbound callers and the Recording notice they hear, Retention (days) (30 to 3,650, 365 out of the box) and the Pause limit (seconds) (180 out of the box) after which someone who paused the recording is reminded and their team lead alerted. Monitoring decides whether people are told when a lead listens in.
Recordings are not in Cape's nightly backup. Whoever runs the server should copy them off the server; see Running Cape.
Allow calling out
- Ask whoever runs the server to switch outbound calling on. Until then, every call out is refused.
- Open Settings, then Calling.
- Under Where calls may go, choose the countries. South Africa is the only one out of the box.
- Under Who may make which calls, tick the kinds of call for Agents and for Leads and managers.
- Under Call length and the account’s cap, set the Longest outbound call (minutes) and the account's daily cap.
- Under Outbound limits, set the Live calls at once, the Dials a day and the Call budget a day (USD).
- Under Consent and existing customers, select Add an existing customer for each customer you make service calls to.
Add numbers that must never be called under Do not call, and the outside numbers people may transfer callers to under Transfers. For campaigns, upload lists under Lists, then set up a campaign under Campaigns. The rules every call out passes are on Cape, the call centre.
Switch on transcripts and summaries
Where Admin was connected when Cape was set up, these are on from the first day; check them here. Anywhere else they are off until you switch them on.
- Open Settings, then AI. The checks beside AI policy say what is missing.
- Set Transcribe calls to On.
- Set Summarise calls to On if you want summaries and suggested outcomes.
- Keep Remove ID and card numbers on: runs of 9 or more digits are taken out before a transcript is saved.
- Add Words to expect: names and terms your calls often contain, separated by commas, so they are spelled right.
- Save.
- Add numbers under Never send to AI for callers whose calls must never be transcribed.
Transcripts are made through Admin's AI, in English only.
Make a test call
- Have someone go available in the console.
- Call one of your numbers from an ordinary phone.
- Check that you hear the greeting, that the call rings in the console, and that the recording appears under Calls.
- On Setup, tick I completed an inbound test call.
Troubleshooting
AI can’t be switched on: recordings aren’t backed up off this server
Cape lets AI on only while the phone provider keeps its own copies of recordings, or while recordings are backed up off the server and a restore has been tried. Cape has no way yet to record that a restore was tried, so ask whoever runs the server to set the provider to keep its copies (CAPE_PROVIDER_RECORDING_DELETE=off); see Running Cape.
The provider change did nothing
Cape reads the provider account when it starts. Have Cape restarted after saving.
Recording is on, but calls are not recorded
Each number has its own Record calls on this number switch. Check it under Numbers.
This line has no business hours set.
Save the weekly hours under Hours. No call goes out without them.