News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Search
Make sure to review our Terms of Use and Community Guidelines.
  Please note the community is currently under maintenance and is read-only.
Home » Developers
Multiple fax numbers
Tags: rest api
Dec 7, 2019 at 8:28am   •   2 replies  •  0 likes
Angelo Bevilacqua

We are developing an app which will use the RingCentral API to send/receive faxes (no voice, sms, ...)

We will have a pool of RingCentral fax numbers under one RingCentral account.

We signed up with RingCentral and started testing using the dev sandbox.


In this context, I am trying to understand the setup of accounts/users/extensions/direct numbers,caller id, etc..


So we have a Main Number which also seems to be our account login username - is this normal ?


When sending faxes, we will pick a number from the pool of RingCentral fax numbers in our account and send a fax FROM that number to an external fax number.


How do we setup the multiple fax numbers that we will need ?

The users/extensions/direct numbers,caller id, etc.. is not very clear to me.


2 Answers
answered on May 23, 2023 at 4:23am  

Ring central fax handling-How to assign different fax number to different practice. Can we have a superadmin that can access all faxes


 0
answered on Dec 8, 2019 at 12:47pm  

Hi Angelo,

Here are the answers for you:

You: We are developing an app which will use the RingCentral API to send/receive faxes (no voice, sms, ...)

Me: Login your developer account at https://developers.ringcentral.com and create a new app. Read this getting started doc for further instructions. Since your app is supposed to send and receive faxes, select the "Faxes" permission, and add the "WebhookSubscriptions" permission if you intend to implement webhook notifications for getting notified when there is an incoming fax. It's up to you to choose Webhook or PubNub notifications though.


You: We will have a pool of RingCentral fax numbers under one RingCentral account.

Me: Login your sandbox account at https://service.devtest.ringcentral.com (using your sandbox account main company number and password). Select the "Users" tab and click the "+ Add User" button. Follow the on-screen instruction to add a new user. Name the new user as e.g. "Fax station 1" and don't forget to add a direct number for that user. Add as many users as you want to have for your "fax pool". Note that sandbox account limit to max 4 users including the default admin user (i.e. the extension 101).


You: We signed up with RingCentral and started testing using the dev sandbox.

Me: Good start!


You: In this context, I am trying to understand the setup of accounts/users/extensions/direct numbers, caller id, etc..

Me: When you signup for a RingCentral developer account, you will have a RingCentral developer account and a RingCentral sandbox account (need activation to set a password) with an assigned main company number. The main company number is the user name for your sandbox account and you can login your sandbox account via https://service.devtest.ringcentral.com, where you can setup your account such as adding a user or changing default settings etc.

"User" and "extension" are the same thing. When talking about a use case, we normally use "user", when talking about technical/programming, we normally use "extension". So when you add a new user, you are adding a new extension to your account.

A user can have it's own phone number (a direct number) so that people can dial that number directly. Otherwise, they have to dial the main company number followed by the * and the extension number (e.g. 16501234567*102)

A caller id is the phone number that will be seen by a callee's when you make a call.


You: So we have a Main Number which also seems to be our account login username - is this normal ?

Me: Yes, and as explained above, this is the user name to login your sandbox account. NOT your developer account.


You: When sending faxes, we will pick a number from the pool of RingCentral fax numbers in our account and send a fax FROM that number to an external fax number.

How do we setup the multiple fax numbers that we will need ?

Me: When you send a fax from any extension under your account, by default the "from" number is your main company number. You cannot specify the from number (see the sample code).

What you want to do is possible only if you setup your account as I discussed above (the "Fax station 1", "Fax station 2" etc. as your users). Then set the Fax settings of each fax station from the Outbound Calls/Faxes setting dialog. Scroll down to set the direct number of the user to be the "Fax number".

To select a fax from your "Fax pool", you have to implement your logic to select a "fax station #", then login the app with that "fax station" (user) login credentials then send your fax.


You: The users/extensions/direct numbers, caller id, etc.. is not very clear to me.

Me: Already explained above


 1
answered on Dec 7, 2019 at 11:45am  

An extension is a group or user mailbox on your RingCentral account.

eg: Extension 101 for user A. Callers can then call the main number of your RingCentral account and dial extension 101 to reach particular user A.

ref:- https://support.ringcentral.com/s/article/5-10-User-Extension-Overview?language=en_US

In RingCentral's terminology, an account means a company(main number) , and an extension often means an user in a company. There can be multiple users or extensions.

ref: https://ringcentral-faq.readthedocs.io/en/latest/account/

A Direct Number is a phone number that can be dialed to connect directly to a User without going through the Operator or Auto-Receptionist. Direct numbers are simply phone numbers that tell the system where to send a call. They don't have the ability to dial out on their own, but can receive calls.

ref: https://community.ringcentral.com/ringcentral/topics/confused-about-adding-user-or-phone-or

https://support.ringcentral.com/s/article/5-10-Adding-Extension-Direct-Numbers-via-Web?language=en_US

Also you can check: https://support.ringcentral.com/s/article/9510?language=en_US


 0



A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

PRODUCTS
RingEX
Message
Video
Phone
OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility
QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us