Phone Numbers

Register your phone numbers in Operator so incoming calls can trigger your agents. Currently supported provider: Twilio.

What this gives you

Once a Twilio number is registered here, every incoming call fires an incoming_call event. Any agent trigger listening for that event will run — for example, to log the call, notify a team, look up the caller in your ERP, or (soon) hand the call to a voice agent.

Before you start

You need:

• A Twilio account with a phone number already purchased or ported into it.
• Either your Twilio Auth Token or an API Key SID + Secret for that account. API Keys are recommended for production because you can revoke them individually.

Add a phone number

1. Open the profile menu → Build → Phone Numbers → Add phone number.
2. Give it a Label (e.g. "Sofia support line") and enter the number in E.164 format (e.g. +15551234567).
3. Choose Twilio as the provider and click Set up Twilio.
4. Pick the authentication mode, paste your credentials, and click Test connection to verify — you should see your Twilio account's friendly name.
5. Click Save on the setup dialog, then Add phone number on the main dialog.

Operator will automatically point the number's Voice webhook at Operator, so no manual configuration in the Twilio console is needed.

Managing a phone number

Each row has a menu with:

• Edit — change the label or update credentials.
• Re-apply webhook — use this if someone changed the Voice URL back in the Twilio console.
• Enable / Disable — pause the number without deleting it.
• Delete — clears the webhook in Twilio and removes stored credentials. The number itself remains in your Twilio account.

Security

Your Twilio credentials are stored server-side in a table that is not readable from the browser. Only Operator's backend can use them to talk to Twilio on your behalf. Incoming webhook calls from Twilio are verified using the stored Auth Token before any event is created.