This article addresses issues regarding number handling at CALLR. For more generic questions about phone numbers, please read our dedicated article: Number types overview.
Countries with available numbers (DIDs)
Our API offers methods to get quotes on, reserve and buy DIDs. You can get the list of countries where the service is offered using the did/areacode.countries method (doc). It returns the list of available countries as well as their code, required by other methods to interact with DIDs.
To buy DIDs in countries that are not part of the list returned by the did/areacode.countries method, please contact our support team.
Number types available in a given country
You can view the number types available in a country using the did/areacode.types method (doc). It returns the list of number types available in a certain country, given the country code as a parameter.
To view the area codes offered within a country, use the did/areacode.get_list method (doc). It returns all the region-specific numbers available, their id, name, and prefix given the country code and number type as parameters.
Gold and Classic numbers
"Gold" (as opposed to "Classic") phone numbers are numbers that are easy to remember because they are sequential, repetitive or both. Here are some examples:
- (646) 345 6789 - sequential
- (646) 286 4545 - repetitive
- (646) 365 3650 - repetitive
- (646) 555 7770 - repetitive (triple-triple)
Buying numbers (DIDs)
If you need to buy a number but are not comfortable using the API, feel free to contact the support team to process your order.
You must reserve numbers using the did/store.reserve method (doc) before being able to buy them. You will receive a reservation status object containing the price, the actual numbers you can buy and an order token. To proceed with your purchase order end effectively buy the desired numbers, use the did/store.buy_order method (doc).
The assignment mode parameter corresponds to the attribution method of the desired numbers:
- Sequential mode assigns numbers preferably following each other: for instance, if you buy three numbers you will get: (646) 982 0820, (646) 982 0821 and (646) 982 0822.
- Random mode assigns numbers randomly.
Cost of a number
You can get number prices (as well as voice and SMS prices) on the pricing section of our website. With the country selector, you can get a summary of the prices for any country you need to contact.
To query the price of phone numbers with the API, use the did/store.get_quote method (doc). It returns the number(s) price in cents (0.01€) and the discount if relevant given the area code, the number class and amount as parameters.
Find out owned numbers (DIDs) using the API
The apps.get_dids method (doc) returns the list of DIDs assigned to your account. It takes a boolean as a parameter to return only the available DIDs (not already assigned to a voice app) if True.
SMS sender ID Personalization
SMS sender identification can be customized using CLI. SMS Sender can be a number or use any alphanumeric characters (A-Z, 0-9, space, -, _). Alphanumeric CLIs are only attributed if they are relevant to the business identity. CLIs for calls and SMS are distinct.
Example of a customized SMS sender ID (YourBrand)
Both LVN (Long Virtual Numbers) and shortcodes can be used as CLIs for voice. Proof of ownership of the phone number/name is required to claim a numeric call CLI.
Authorizations of new alphanumeric CLIs are verified by our support team to protect end-users from any possible fraud. We refuse alphanumeric CLIs that are too broad or voluntarily vague (example: "Your Bank").
You need documents to prove your ownership of the desired name. To begin the process, please contact the support team.
Cost of a CLI
There is no extra charge to use a CLI. Please read the previous section to learn more about the detail of the procedure.
Any number bought using CALLR can be used as a CLI. Contact the support team and specify the DIDs you wish to use as CLIs to get the process started.
Handling STOP command with an alphanumeric sender ID
If you use an alphanumeric sender ID, the SMS campaign can only be one way. Your customers can't reply to your messages. If you are operating in a country that requires STOP command compliance you need to include an option for your users to unsubscribe.
You can do so by using the special string %STOPNUM% - we'll replace it by a number to process the STOP commands you receive.