For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/phone-systems/yeastar.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.
Yeastar
How Voice Logica connects
Section titled “How Voice Logica connects”The Yeastar registers a SIP trunk to Voice Logica (way 1), the same way it registers to a phone provider. Voice Logica creates the trunk and gives you a server, a username and a password; the PBX connects out, so no port forwarding is needed.
- Calls the PBX sends to this trunk are answered by the AI agent.
- The agent transfers callers back over the same trunk, and the PBX rings the extension through an inbound route.
1. Create the connection in Voice Logica
Section titled “1. Create the connection in Voice Logica”Telephony - Trunks - Connect your PBX, pick Yeastar P-Series or Yeastar S-Series and the agent. Keep the dialog open until it says Connected.
2. Add the trunk, routes and transfers
Section titled “2. Add the trunk, routes and transfers”- Extension and Trunk → Trunk → Add. Name
Voice Logica, Trunk Status Enabled, ITSP Template General. - Trunk Type = Register Trunk. Transport UDP, Hostname/IP = the server, Port 5060, Domain = the server.
- Username and Authentication Name = the username, Password = the password.
- Advanced → Codec Setting: G.711 A-law first, then u-law. Advanced → VoIP Setting → DTMF Mode = RFC4733 (RFC2833), Qualify on.
- Save and Apply. The trunk list shows the registration status.
Send calls to the agent: Call Control → Outbound Route → Add, a dial pattern (for example a short code) with the Voice Logica trunk, or send an IVR option, a queue’s failover or after-hours calls to it.
Transfers back: Call Control → Inbound Route → Add, Trunk = Voice Logica, DID Pattern matching your extensions, destination the extensions.
- Settings → PBX → Trunks → Add, type Register Trunk (VoIP).
- Transport UDP, Hostname/IP = the server, Port 5060, Domain = the server.
- Username and Authentication Name = the username, Password = the password.
- Advanced: DTMF Mode RFC2833, Qualify on. Codecs: G.711 A-law, then u-law.
- Save and Apply. Check the trunk in PBX Monitor.
Send calls to the agent: Settings → PBX → Call Control → Outbound Routes with the Voice Logica trunk, or an IVR option pointing at it.
Transfers back: Settings → PBX → Call Control → Inbound Routes, Member Trunks = Voice Logica, destination your extensions.
Then, in Voice Logica, add the extensions as transfer destinations on the agent: an External destination with the extension number (for example 201), or a User with that extension. Use Warm transfer, so the agent comes back and takes a message when nobody answers.
3. Check it works
Section titled “3. Check it works”- The dialog says Connected; the trunk’s SIP logs in Voice Logica show each REGISTER and our reply.
- Call the route from an extension: the call appears in Calls.
- Ask the agent for a colleague: the extension rings.
Good to know
Section titled “Good to know”- The Yeastar firewall blocks SIP from outside the PBX’s own subnet by default. The trunk registers out, so it is not affected, but an edge device on another subnet must be allowed in the PBX firewall.
- Turn off SIP ALG on the office router.
- A Warm transfer uses two trunk channels until it connects.
Frequently asked questions
Section titled “Frequently asked questions”How do I connect my Yeastar P-Series or S-Series to Voice Logica?
The Yeastar registers a SIP trunk to Voice Logica, the same way it registers to a phone provider. In Voice Logica, open Telephony - Trunks - Connect your PBX and pick Yeastar P-Series or Yeastar S-Series and the agent to get a server, a username and a password. On the Yeastar, add a Register Trunk with the server as Hostname/IP and Domain (UDP, port 5060) and the username and password, then Save and Apply; the Voice Logica dialog says Connected when it registers.
Do I need port forwarding or a public IP on my Yeastar for Voice Logica?
No. The Yeastar connects out to Voice Logica, so no port forwarding is needed and nothing is opened on your firewall. The Yeastar firewall blocks SIP from outside the PBX’s own subnet by default, but the trunk registers out, so it is not affected. Turn off SIP ALG on the office router.
How do I send Yeastar calls, such as an IVR option or after-hours calls, to the AI agent?
Add an outbound route with a dial pattern, for example a short code, that uses the Voice Logica trunk (P-Series: Call Control → Outbound Route; S-Series: Settings → PBX → Call Control → Outbound Routes). You can also point an IVR option at the Voice Logica trunk, and on the P-Series a queue’s failover or after-hours calls as well.
Can the AI agent transfer calls back to Yeastar extensions?
Yes. Add an inbound route for the Voice Logica trunk with your extensions as destination (P-Series: Call Control → Inbound Route; S-Series: Settings → PBX → Call Control → Inbound Routes). In Voice Logica, add the extensions to the agent as an External destination with the extension number (for example 201) or a User with that extension. Use Warm transfer, so the agent comes back and takes a message when nobody answers.
How many Yeastar trunk channels does a call with the AI agent use?
Each call with the agent uses one trunk channel. A Warm transfer uses two, the caller and the extension, until it connects. Size the Yeastar’s SIP channels for that.
