Security update: RingQ is patched against the critical PHP vulnerabilities. Update your servers today.

Read now
RingQ Customer Centric Communications

Telegram Voice Calls with RingQ

Telegram voice calls for business: with the RingQ Telegram integration, customers who use Telegram call your business with a normal Telegram voice call, and the call rings your RingQ extension, queue or IVR like any other call in your cloud phone system. Your team answers it on the web app, the RingQ mobile app or a desk phone. No extra software is needed on your RingQ server: the connection runs through the RingQ Telegram service.

What you need

  • A Telegram account for your business, signed in on a phone. We recommend a dedicated number, because the Telegram app on that phone receives the one-time verification code.
  • Telegram API credentials for that account: an api_id and api_hash. Get them at my.telegram.org, sign in with the same number, open "API development tools" and create an application (any name and short name).
  • Administrator access to your RingQ web app.

Connect your Telegram number

  1. In the RingQ web app, open Integrations and click the Telegram card.
  2. Enter the Telegram number with the country code, the api_id and the api_hash. Customer name and PBX IP / FQDN are filled in for you.
  3. Click Request OTP. Telegram sends a verification code to the Telegram app on your phone.
  4. Enter the code and click Verify OTP. The dialog shows "Telegram integration active".
  5. RingQ then opens Call Flow with Add SIP Trunk already filled in on the Telegram template (host, port and your Telegram number). Click Save.

Choose where Telegram calls ring

In Call Flow, add an inbound route for your Telegram number and point it to an extension, a queue or an IVR. From then on every Telegram call to your business number rings there. Telegram callers show their Telegram name and number in Call Status and in the call log.

Calling Telegram users from RingQ

To call a Telegram user, add an outbound route that uses the Telegram trunk and dial the person's phone number with the country code, for example +6591234567. The person must allow calls from your business account in their Telegram privacy settings, or have your number in their contacts.

Menus and extensions during a Telegram call

Telegram has no in-call keypad. If a caller reaches an IVR and needs to press a digit, they can type the digits as a text message in the Telegram chat with your business number while the call is up. RingQ turns the digits into key presses on the call.

Manage the connection

Open Integrations > Telegram at any time to restart the service, view the logs, stop the service or delete the configuration. If you delete the configuration and set it up again, Telegram sends a new verification code.

Tips

  • Keep the Telegram app signed in on the business phone. If you sign out of all devices from the Telegram app, the RingQ connection is also signed out and you need to set it up again.
  • Calls use the Opus codec for the best audio quality. RingQ adds it automatically; nothing to change on your side.

Related guides