Connect your PBX
Keep your office phone system and add an AI agent to it. Your PBX registers a SIP trunk out to Voice Logica, like it does with a phone provider. Nothing opens a port, and the PBX needs no public IP.
Once connected:
- the PBX sends the calls you choose to the AI agent: a number, an IVR option, a queue overflow, after-hours calls or a short code;
- the agent can transfer callers back to your extensions over the same trunk.
In the app
Section titled “In the app”- Go to Telephony - Trunks and click Connect your PBX.
- Pick your phone system and the AI agent that answers the calls. Click Create connection.
- Copy the server, port, username and password into the PBX. Save the password: it is shown only once.
- Follow the steps for your make, which the dialog shows with your values already filled in.
- Leave the dialog open. It changes to Connected as soon as the PBX registers, usually within a minute.
If it says Your PBX was rejected, the password or username is wrong. If it keeps Waiting for your PBX, see Troubleshooting.
From Claude or ChatGPT
Section titled “From Claude or ChatGPT”With the Voice Logica connector, say “connect my Panasonic PBX to my agent”. The assistant creates the connection (connect_pbx), gives you the values, walks you through the steps one at a time, and checks the connection (pbx_query, action "check_pbx_connection") until it is live.
The values
Section titled “The values”| Field on the PBX | Value |
|---|---|
| Server, registrar, proxy, domain | <your-company>.sip.voicelogica.ai (shown in the dialog) |
| Port | 5060 over UDP (5061 for TLS) |
| Username and authentication ID | the generated username, for example pbx123456 |
| Password | the generated password |
| Registration | on |
| Codecs | G.711 A-law first, then G.711 u-law |
| DTMF | RFC 2833 / RFC 4733 (out of band) |
Steps per phone system
Section titled “Steps per phone system”Each make has its own page under Phone systems (PBX): how Voice Logica connects to it, what licences or cards it needs, the trunk steps in its own menus, how to send calls to the agent and how the agent transfers back to extensions. The dialog shows the same steps with your values filled in, and links the page for your make.
| Phone system | Page |
|---|---|
| Panasonic KX-NS / NSX, KX-TDE / NCP, KX-HTS, KX-TDA15 / TDA30 | Panasonic |
| Panasonic KX-TDA100-600, KX-TES / TEM / TA and other analog or ISDN systems | Analog and ISDN systems |
| Grandstream UCM | Grandstream |
| Yeastar P-Series, S-Series | Yeastar |
| 3CX | 3CX |
| FreePBX, Asterisk, Issabel, Elastix | FreePBX, Asterisk, Issabel |
| Alcatel-Lucent OXO | Alcatel-Lucent OXO |
| Avaya IP Office | Avaya IP Office |
| Unify OpenScape Business, Siemens HiPath | Unify / Siemens |
| Ericsson-LG iPECS | iPECS |
| NEC SL2100, SL1100, SV9100 | NEC |
| Mitel, Samsung, Cisco, Wildix, Zycoo, Xorcom, any SIP PBX | Other makes |
Transfers back to extensions
Section titled “Transfers back to extensions”The agent hands the caller back over the same trunk with the extension number, and the PBX rings the extension. Add each extension as a transfer destination on the agent: an External destination with the extension number (for example 201), or a User with that extension. Use Warm transfer: if nobody answers, the agent comes back and takes a message. A Warm transfer uses two trunk channels until it connects.
Troubleshooting
Section titled “Troubleshooting”- Waiting for your PBX: nothing has arrived yet. Check the trunk is saved and enabled with registration on, the server and username are exactly as shown, and the PBX can reach the internet on UDP 5060. Turn off SIP ALG on the office router: it rewrites SIP and is the most common cause. Some PBXs need a restart (Panasonic: card OUS, then INS).
- Your PBX was rejected: the password or username is wrong. Username and authentication ID must both be the generated username. Some PBXs keep the old password until the trunk is restarted.
- Connected, but no audio: allow RTP (UDP) out from the PBX and turn off SIP ALG.
- The trunk’s SIP logs (Telephony - Trunks → the trunk) show every REGISTER and our reply.
A PBX that cannot register a SIP trunk but takes SIP extensions is reached through an edge device. A PBX with no SIP at all connects through a gateway: see Analog and ISDN systems.
Questions
Section titled “Questions”Does this use my phone lines or numbers?
No. Your lines stay on the PBX. The trunk only carries the calls your PBX sends to the agent and the transfers back.
I lost the password.
Open the trunk in Telephony - Trunks, set a new password, and enter it on the PBX.
Can I connect more than one PBX?
Yes. Each connection gets its own username, so each site or PBX registers separately.