Zum Inhalt springen
DE
App öffnen

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/telephony/connect-your-pbx.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

Connect your PBX

5 Min. Lesezeit
Als Markdown kopieren
Als Markdown ansehenDie rohe .md-Datei öffnen.md

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

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.
  1. Go to Telephony - Trunks and click Connect your PBX.
  2. Pick your phone system and the AI agent that answers the calls. Click Create connection.
  3. Copy the server, port, username and password into the PBX. Save the password: it is shown only once.
  4. Follow the steps for your make, which the dialog shows with your values already filled in.
  5. 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.

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.

Field on the PBXValue
Server, registrar, proxy, domain<your-company>.sip.voicelogica.ai (shown in the dialog)
Port5060 over UDP (5061 for TLS)
Username and authentication IDthe generated username, for example pbx123456
Passwordthe generated password
Registrationon
CodecsG.711 A-law first, then G.711 u-law
DTMFRFC 2833 / RFC 4733 (out of band)

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 systemPage
Panasonic KX-NS / NSX, KX-TDE / NCP, KX-HTS, KX-TDA15 / TDA30Panasonic
Panasonic KX-TDA100-600, KX-TES / TEM / TA and other analog or ISDN systemsAnalog and ISDN systems
Grandstream UCMGrandstream
Yeastar P-Series, S-SeriesYeastar
3CX3CX
FreePBX, Asterisk, Issabel, ElastixFreePBX, Asterisk, Issabel
Alcatel-Lucent OXOAlcatel-Lucent OXO
Avaya IP OfficeAvaya IP Office
Unify OpenScape Business, Siemens HiPathUnify / Siemens
Ericsson-LG iPECSiPECS
NEC SL2100, SL1100, SV9100NEC
Mitel, Samsung, Cisco, Wildix, Zycoo, Xorcom, any SIP PBXOther makes

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.

  • 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.

Does connecting my PBX to Voice Logica 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 trunk password for my PBX connection. What do I do?

Open the trunk in Telephony - Trunks, set a new password, and enter the same password on the PBX.

Can I connect more than one PBX to Voice Logica?

Yes. Each connection gets its own username, so each site or PBX registers separately.

Will I be notified if my PBX goes offline?

Yes. If the PBX stops registering for more than 10 minutes, we email a Phone System Offline alert, repeated every 4 hours until the PBX registers again; the trunk then recovers on its own. No alert is sent outside your business hours, since many PBXs are switched off at night.

The alert goes to the email list in the Low balance alert card (Subscription & Billing → Subscription management), or to the company email when that list is empty. That list also receives low balance alerts: there is no separate list for outage alerts only. See Low balance alert, and If a connection drops for what callers notice.