For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/phone-systems/grandstream.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.
Grandstream UCM
Esta página aún no está disponible en tu idioma.
How Voice Logica connects
Section titled “How Voice Logica connects”The UCM registers a SIP trunk to Voice Logica (way 1). Voice Logica creates the trunk and gives you a server, a username and a password; on the UCM it is a normal Register SIP Trunk, as with any phone provider. The UCM connects out, so no port forwarding is needed.
- Calls the UCM sends to this trunk are answered by the AI agent.
- The agent transfers callers back over the same trunk, and the UCM rings the extension through an inbound route.
No licence is needed: SIP trunks are built into every UCM. The same menus apply to the UCM6300 / 6300A, UCM6200 (end of life), UCM6510 and CloudUCM.
1. Create the connection in Voice Logica
Section titled “1. Create the connection in Voice Logica”Telephony - Trunks - Connect your PBX, pick Grandstream UCM and the agent. Keep the dialog open: it shows the values and changes to Connected when the UCM registers.
2. Add the trunk on the UCM
Section titled “2. Add the trunk on the UCM”- Extension/Trunk → VoIP Trunks → Add, type Register SIP Trunk.
- Provider Name
Voice Logica. Host Name = the server from the dialog (port 5060). Transport UDP. - Username and Auth ID = the username, Password = the password.
- Leave Keep Trunk CID off, so each extension’s caller ID is kept.
- Advanced Settings: Codec Preference PCMA first, then PCMU. DTMF Mode = RFC4733. Turn on Enable Heartbeat Detection. Leave Auth Trunk off: with it on, the UCM challenges our calls and transfers back fail.
- Save and Apply Changes. The trunk shows as registered within a minute.
UCM6100 (older firmware): the same fields are under PBX → Basic/Call Routes → VoIP Trunks → Create New Trunk, and routes under PBX → Basic/Call Routes.
3. Send calls to the agent
Section titled “3. Send calls to the agent”Choose which calls the agent answers:
- A short code or prefix: Extension/Trunk → Outbound Routes → Add, with a Pattern (for example
_9XXor a dedicated code) and Use Trunk = the Voice Logica trunk. - A number, an IVR option, a ring group or queue overflow, after-hours calls: point that destination at the outbound route above.
4. Let the agent transfer back to extensions
Section titled “4. Let the agent transfer back to extensions”Extension/Trunk → Inbound Routes → Add for the Voice Logica trunk: DID Pattern that matches your extensions (for example _2XX), destination By DID or the extension. 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.
5. Check it works
Section titled “5. Check it works”- The dialog says Connected. In Voice Logica, the trunk’s SIP logs show each REGISTER and our reply.
- Dial the short code or the number from an extension: the call appears in Calls with the agent.
- Ask the agent for a colleague: the extension rings.
Good to know
Section titled “Good to know”- Behind NAT: PBX Settings → SIP Settings → NAT, set External Host (your public IP or hostname) and Local Network Address. On UCM630x, also turn off UCM RemoteConnect (MediaNAT traversal) if trunk audio is one-way.
- TLS instead of UDP: set Transport TLS and port 5061 on the UCM, and set the same transport and port on the trunk in Voice Logica (Telephony - Trunks, edit the trunk). If the two differ, the agent answers but the call drops after about 35 seconds.
- Turn off SIP ALG on the office router.
- Each call with the agent uses one trunk channel; a Warm transfer uses two until it connects.
- No trunk at all? A UCM can also take Voice Logica as an extension through an edge device, but the trunk is simpler.
Frequently asked questions
Section titled “Frequently asked questions”How do I connect my Grandstream UCM to Voice Logica?
In Voice Logica, open Telephony - Trunks - Connect your PBX and pick Grandstream UCM and the agent to get a server, a username and a password. On the UCM, go to Extension/Trunk → VoIP Trunks → Add, choose Register SIP Trunk, enter the server as Host Name (port 5060, UDP) with the username and password, then Save and Apply Changes. The trunk registers within a minute and the Voice Logica dialog changes to Connected.
Do I need a licence on my Grandstream UCM to connect to Voice Logica?
No. SIP trunks are built into every Grandstream UCM, so no licence is needed. The same menus apply to the UCM6300 / 6300A, UCM6200, UCM6510 and CloudUCM; on the older UCM6100 the fields are under PBX → Basic/Call Routes.
Can the AI agent transfer calls back to Grandstream UCM extensions?
Yes. On the UCM, add an inbound route for the Voice Logica trunk in Extension/Trunk → Inbound Routes with a DID Pattern that matches your extensions (for example _2XX) and destination By DID or the extension. In Voice Logica, add the extensions to the agent as an External destination with the extension number or a User with that extension. Use Warm transfer, so the agent comes back and takes a message when nobody answers.
Why do transfers back to my Grandstream UCM fail?
Check Auth Trunk in the Advanced Settings of the Voice Logica trunk on the UCM and leave it off. With Auth Trunk on, the UCM challenges Voice Logica’s calls and transfers back fail. Also check that an inbound route for the Voice Logica trunk has a DID Pattern matching your extensions.
Why does a call with the agent on my Grandstream UCM drop after about 35 seconds?
This happens when the transport and port differ between the UCM and the Voice Logica trunk. If you use TLS, set Transport TLS and port 5061 on the UCM, and the same transport and port on the trunk in Voice Logica (Telephony - Trunks, edit the trunk). If the two differ, the agent answers but the call drops after about 35 seconds.
Why is the audio one-way on my Grandstream UCM trunk to Voice Logica?
If the UCM is behind NAT, set External Host (your public IP or hostname) and Local Network Address in PBX Settings → SIP Settings → NAT. On a UCM630x, also turn off UCM RemoteConnect (MediaNAT traversal) if trunk audio is one-way. Turn off SIP ALG on the office router as well.
