Developer docs

Product facts, SIP and PBX, and the consumer API.

What we are

Widely is the commercial communications service. It is powered by Swiftcom, the communications technology platform from Swift Mobile Solutions Ltd (https://swiftmobilesolutions.com/). A branded VoIP app for an operator who keeps their own SIP and SMS trunks is sold at https://swiftmobilesolutions.com/white-label. That offer is not sold on this site, and it does not include the Widely MCP server.
Connectivity providers who want to connect a service they already sell start at https://widely-mobile.com/en/integrate. Selling SIM plans to Widely users starts at https://widely-mobile.com/en/partners. An interconnect relationship does not by itself publish a marketplace offer.
Widely is a consumer communications app: your SIM number and/or a Widely number, on iOS, Android, web, and desktop.
Widely is also a communications platform: one account for SIM calls, eSIM data, local numbers, and (on Plus) an office phone system. The door someone arrived through stays first.
The public website is https://widely-mobile.com (apps: Widely Mobile). That is the canonical domain — not widely.io.
Receive SIM calls: people call your SIM; it rings in Widely. Free Widely setup where a public forwarding number exists (currently Israel, the UK, and the US), on every tier, unrelated to eSIM.
Free, Pro, and Plus are platform capability plans. New accounts start Free. Membership belongs to each user, so one account may mix Free, Pro, and Plus people. Add as many users as needed. The account owner must be Plus for shared PBX objects such as AI receptionists, phone menus, queues, and shared numbers to operate; each queue agent and shared-number user must also be Plus.
The Pro trial is an explicit 14-day opt-in. Starting it requires a saved payment method. It becomes a paid, auto-renewing Pro membership after 14 days unless the customer cancels before renewal.
Mobile data is pay as you go from the wallet in 0.1 GB steps — there is no prepaid GB pack, and unused wallet credit does not expire. Volume pricing is a marginal ladder inside each rolling 30-day usage period: the price per GB drops as you use more within the same billing period. The period starts in the highest-priced band and later usage in that same period reaches cheaper bands. When the period rolls, the ladder starts again at the expensive band. Usage across countries shares one period total; each country keeps its own live rate. A quoted 5 GB or 10 GB total is for that volume used inside one period, not spread across months. Never derive a per-GB rate by dividing a usage total. There is no usage-triggered Pro charge.
Numbers, calls, messages, data, and extra channel capacity stay pay as you go on every plan. A platform tier does not include a DID, minutes, messages, data, or wallet credit.
Mobile data is a pay-as-you-go eSIM from the wallet — not country bundles or a prepaid pack shop.
Local numbers so family abroad can dial local; you answer in-app.
Person-to-person SMS to ordinary carrier numbers that do not have the app, plus in-app chat between Widely users — not bulk, marketing campaigns, or automated business notifications.
Widely can send person-to-person SMS through the SMS gateway to ordinary carrier numbers that do not have the app. Those SMS are charged from the wallet (pay as you go). Calls also work to external PSTN numbers that do not have the app.
In-app chat / Widely messaging between two Widely users is a separate path: that is the one that requires both people on Widely.
On Plus, Widely can be the office phone system: AI receptionists and phone menus (IVR), call queues, a shared office number, and outbound caller ID from the app on staff mobiles.
On Plus, Widely can be the office phone system: AI receptionists and phone menus (IVR), call queues, a shared office number, and outbound caller ID from the app on staff mobiles.

What we are not

Not an Airalo clone or a prepaid country-pack shop.
Not a bulk SMS platform.
Not the underlying mobile network, and not a single carrier that replaces every provider.
Not a directory of carrier names. Public marketplace discovery lists approved offers only.

Marketplace services

Marketplace discovery lists approved offers only. An interconnect relationship is not a listing.
A data-only travel eSIM is a Widely product, not a partner offer.
Selling SIM plans on Widely starts at https://widely-mobile.com/en/partners.
Connecting a service they already sell starts at https://widely-mobile.com/en/integrate.
No marketplace services are listed.

Services Widely can quote

Widely travel data is pay-as-you-go eSIM data for a trip. The price is the public rate for that country. It is not a partner mobile service. A directory connection returns a Widely link when the eSIM has to be ordered.
A Widely phone number is quoted from the public rate checker for that country. Buying it finishes in Widely.
Moving an existing number to Widely is quoted first. The move is not instant and finishes in Widely.
Receive SIM calls rings an existing SIM in Widely where a public forwarding number exists. That is voice on the current SIM, not a new marketplace mobile service.
A home mobile service is a marketplace offer. It appears only after that offer has passed testing and is listed. Discovery does not invent voice, SMS, a physical SIM, or a kosher line.
Pro and Plus monthly prices are public. Changing the plan finishes in Widely. A ChatGPT or Claude directory connection does not charge for the plan.
Plus is assigned per user. The owner needs it for shared phone-system features, and queue agents or shared-number users need it too. The plan change finishes in Widely.
An office phone system can be proposed from the number of people, numbers, hours, a menu, a queue, and an AI receptionist. The price is the plan list price. Nothing is created until the account continues in Widely.
An AI receptionist answers callers on Plus. It can be part of a phone-system proposal. It speaks with the caller and does not transfer that live conversation to a person.
WhatsApp AI answers a number the account owns, using that receptionist's knowledge. The monthly fee includes 1,000 replies.
On Plus the connected assistant can call and speak. That is for an account that already has Widely, after the person has approved it.
ChatGPT and Claude directory connections can read these prices and prepare an order. They do not buy a number, order an eSIM, change the plan, or move wallet money inside that host.

Numbers, calls, messages, data, and extra channel capacity stay pay as you go on every plan. A platform tier does not include a DID, minutes, messages, data, or wallet credit.

Practical setup

getting-started-payments

Downloading Widely and setting up an account does not require an immediate payment.
Numbers, outbound calls, messages, and mobile data are pay as you go from the Widely wallet. Add funds before using a paid service; for travel, top up and test everything before leaving home.
Paid telecom is available on Free. Membership gates platform features; it does not unlock ordinary PAYG usage.

wallet-ledger-charges

An unexpected wallet debit is explained by the live wallet ledger, not by handing the thread to a person. Call list_wallet_activity (and get_account_balance) and name the matching row: amount, when, and the customer-facing description.
Do not quote opaque ledger codes. esim_another_device_fee is the “eSIM for another device” fee for the other-device path: it exists so the customer does not run Widely on phone A and install the eSIM on phone B, because Support only has eyes on the app device. It is not a PAYG data charge.
If that fee is on the ledger but device evidence (IFV / install fingerprint) shows the eSIM is on the same phone as the Widely app, the fee should not be kept. Explain that and that Support credits / will credit it. Do not canned-handoff.
Only hand off after that ledger check if no matching debit is listed, the rows are ambiguous, or the customer still disputes a real other-device fee after a clear explanation.

phone-verification

Phone verification — at signup, at login, and when adding a number — sends a 6-digit code on WhatsApp, by SMS, or as a spoken call. WhatsApp is the default channel for a mobile number: the code arrives as a WhatsApp message from Widely, and the customer can reply in that chat for help.
WhatsApp is one of the three verification channels, alongside SMS and a spoken call. The verify screen offers whichever suit the number, so a customer who does not want WhatsApp can switch to SMS or a call.
WhatsApp verification works on mobile numbers, including Israeli kosher mobile prefixes that cannot receive SMS at all. A clear landline can use neither WhatsApp nor SMS and is verified by a spoken call.
The WhatsApp code arrives in the app language. If WhatsApp delivery fails, Widely retries automatically by SMS, or by call when SMS is unavailable for that number — so a customer expecting WhatsApp may receive the code another way.

app-integrity

When the Widely app crashes, force-closes, or will not open — on WhatsApp or in the app — tell them to update Widely from the App Store or Google Play, force-quit the app, and restart the phone. Then ask when it crashes (what they were doing) and which phone OS and version they are on.
Do not tell a customer to delete the app, remove it, or clear the app cache. That can lose data and the eSIM setup. The same steps apply on every Support channel.

delete-account

Someone asking to delete or close their Widely account is usually unhappy about one thing: a number they no longer want, a renewal or charge, forwarding they want undone, credit left over, or something not working. Support does not walk them through deleting the account. It looks at the account first (numbers, renewals, forwarding, wallet balance, recent usage), asks what is behind it, and solves that.
What Support can sort out instead: stop a renewal or a charge, close a number (Phone numbers → the number → Cancel Renewal; it stays active until the period ends), stop forwarding (turn off Receive SIM calls, then dial ##21# from that SIM), or fix what is broken. Wallet credit belongs to the customer and can be refunded if the account closes.
Only if they still want the account closed after that does Support pass it on, with a plain line: "I've passed this on. You'll get an answer here in this chat."

card-payment-failed

In the new-card form, enter the cardholder name as printed on the card using English (Latin) letters. Revolut removes non-Latin characters from this field, so a Hebrew-only name can stop the card payment before the bank 3-D Secure verification screen appears.
When a new-card top-up fails before the bank verification screen appears, first ask whether the cardholder name was entered in Hebrew or another non-Latin script. Do not ask the customer to send their name, card number, password, or verification code. Tell them to retry and type the name in English letters.
This cardholder-name check applies to the new-card form. Do not diagnose Google Pay, Apple Pay, a saved card, or bank transfer with it unless the customer says they used the new-card form.

travel-esim-setup

Ready to travel gathers eSIM, Receive SIM calls, and wallet in one place. Those are separate products: Receive SIM calls does not require an eSIM. Send travellers there for trip prep rather than the separate eSIM or Receive SIM calls screens.
Add wallet credit before installing an eSIM. Downloading and installing the Widely eSIM needs an internet connection. Install and test it on Wi-Fi before travelling rather than waiting until arrival.
Once the eSIM is installed and connected, it supplies mobile data abroad. From the app, calls and messages need either Wi-Fi or mobile data — that is the sender’s connection, not a requirement that the other person install Widely.
Incoming SMS while roaming usually works and is free: receiving SMS does not accrue roaming charges. The recommended travel pattern is to leave the home SIM on (including a UK SIM), forward calls to Widely, and use Widely for data. Incoming SMS continues to arrive on the home SIM, with no roaming charge for receiving texts.
Mobile data is pay as you go from the wallet in 0.1 GB steps — there is no prepaid GB pack, and unused wallet credit does not expire. Volume pricing is a marginal ladder inside each rolling 30-day usage period: the price per GB drops as you use more within the same billing period. The period starts in the highest-priced band and later usage in that same period reaches cheaper bands. When the period rolls, the ladder starts again at the expensive band. Usage across countries shares one period total; each country keeps its own live rate. A quoted 5 GB or 10 GB total is for that volume used inside one period, not spread across months. Never derive a per-GB rate by dividing a usage total. There is no usage-triggered Pro charge.

travel-coverage

Never say Widely works in every country or worldwide. Ask which destination they need, then quote the live per-GB Rate Checker figure for that country. A missing quote means it is not priced, not that it works everywhere.
Mobile data is pay as you go from the wallet in 0.1 GB steps — there is no prepaid GB pack, and unused wallet credit does not expire. Volume pricing is a marginal ladder inside each rolling 30-day usage period: the price per GB drops as you use more within the same billing period. The period starts in the highest-priced band and later usage in that same period reaches cheaper bands. When the period rolls, the ladder starts again at the expensive band. Usage across countries shares one period total; each country keeps its own live rate. A quoted 5 GB or 10 GB total is for that volume used inside one period, not spread across months. Never derive a per-GB rate by dividing a usage total. There is no usage-triggered Pro charge.
After a destination quote or a coverage question, send the in-app Rate Checker as the single URL. Do not dump unrelated app links.

desk-travel-esim

When traveling with the Widely eSIM, keep your home SIM switched on so its texts keep arriving.
If Receive SIM calls is on, calls to your home number already forward to the Widely app.
When you land, switch mobile data to the Widely eSIM.
If the customer asks whether to turn the Widely eSIM on and their own SIM off, answer directly: keep both on, and use the Widely eSIM for mobile data.

receive-sim-calls

Receive SIM calls can set up more than one external mobile or landline number. Each line must support unconditional call forwarding to the Widely number shown during setup.
For each line: verify the number, use the public forwarding number when one exists or get a local Widely number if prompted, tap Turn it on, place the prepared carrier code from that line, return to Widely, and run Check again.
To cancel call divert, use the Receive SIM calls toggle in the app (https://webapp.widely-mobile.com/call-forwarding) and turn off Call Forwarding in phone settings. From the SIM line the typical GSM cancel is ##21#.
Where Widely provides a shared public forwarding number (currently Israel, the UK, and the US), Receive SIM calls has no Widely setup or number fee. It is available on Free, Pro, and Plus and does not require an eSIM.
The SIM forwards to a regular local number. Carriers usually do not add a special forwarding fee because those minutes are typically already in the mobile plan.
Forwarding is turned on at the mobile carrier, not in Widely. Codes and menus differ by operator, and some carriers (for example Golan Telecom) need a portal. Widely gives the destination, Turn it on, and Check on a best-effort basis and cannot guarantee that a given carrier will enable unconditional forward.
If there is no shared public forwarding number for the SIM country, the user may need their own local Widely number, which is paid. Answering these calls in Widely is free; only the number's monthly fee applies. Calls you make stay pay as you go.
Receive SIM calls is voice only. Call forwarding does not forward SMS — texts stay on the physical SIM. SMS on the SIM needs number porting where that is offered, if those texts should arrive inside Widely while the home SIM is off.
Incoming SMS while roaming usually works and is free: receiving SMS does not accrue roaming charges. The recommended travel pattern is to leave the home SIM on (including a UK SIM), forward calls to Widely, and use Widely for data. Incoming SMS continues to arrive on the home SIM, with no roaming charge for receiving texts.

local-number-calling

Buy an Israeli or other local number on Phone numbers. Incoming calls to it ring in Widely.
Incoming calls to a Widely phone number — a US, UK, Israeli or any other number bought on Phone numbers — are free for the member: no per-minute charge and nothing taken from the wallet. Only the number’s monthly fee applies. The caller pays only what their own carrier charges to dial that local number.
For outbound calls, select that number as the Caller ID before dialling; it can be shown when calling Israeli numbers as well as other destinations.
From the Widely app, outbound calls to Israel always use international E.164 (+972…), including while you are physically in Israel. Enter the full number with +972 — never a local 0-dial or area-code-only form such as 03….
Phone numbers offer Number only and, for retail use only, Calls included. Calls included — for example the £4.99/month UK number with UK outgoing calls included — is a retail option for personal use, typically one person. It is not offered on a number that rings to a queue (a PBX queue or ring group), or on a number used as caller ID by two or more seats (a shared number). Those numbers are Number only: outgoing calls are not included and are billed per minute at the usual rates. Being on a Plus plan does not exclude Calls included.
Choosing Number only does not require Pro. The first active number is available on Free; the platform number limit applies when adding more numbers.
Retail Number only and Calls included prices are the published shelf prices; members on a retail number are not moved onto a cost-plus floor when a sticker exists, including members on a Plus plan. A number that rings to a queue (a PBX queue or ring group), or a number used as caller ID by two or more seats (a shared number), is not offered Calls included. No new price is invented for those numbers: outgoing calls are simply not included and are billed per minute. Once a number joins a queue or becomes shared, its included outgoing calls stop immediately, and its outgoing calls are then billed per minute.
Some countries require registration before you can buy a number there. When the app shows 'Registration required', first add your identity details and an address in that country (some countries also ask for a passport or ID copy), then buy the number. If the app doesn't show the form, use the web app at webapp.widely-mobile.com to complete the details and buy. The number activates once verification is approved. A payment hold is placed at purchase; the account is not debited until verification is approved.
To receive calls from your SIM in Widely, you need a Widely number from the same country unless Widely offers a shared forwarding number there (currently US, UK and Israel).

in-app-il-outbound-dialing

From the Widely app, outbound calls to Israel always use international E.164 (+972…), including while you are physically in Israel. Enter the full number with +972 — never a local 0-dial or area-code-only form such as 03….
Local 0-dial (for example 03…) is only for the phone's native SIM/PSTN keypad while that SIM is used in Israel. The Widely in-app keypad does not follow the country's local dialing plan; being in Israel does not change the format.

external-sms-and-in-app-chat

Widely can send person-to-person SMS through the SMS gateway to ordinary carrier numbers that do not have the app. Those SMS are charged from the wallet (pay as you go). Calls also work to external PSTN numbers that do not have the app.
In-app chat / Widely messaging between two Widely users is a separate path: that is the one that requires both people on Widely.
What the other person receives as SMS depends on the sender’s app edition. full_content sends the message text as SMS. invite_notify sends a notification that they have a message plus a link to open Widely — not the full text. hybrid can do either; by default it sends the notification, not the full text, unless the sender chooses to send the full SMS. Photos, video, and files are not delivered over SMS (in-app only).
How I message is the setting for SMS fallback when you (a Widely user) are offline. That is not the same as sending SMS to someone who does not have Widely.

plans-and-trials

The Pro trial is an explicit 14-day opt-in. Starting it requires a saved payment method. It becomes a paid, auto-renewing Pro membership after 14 days unless the customer cancels before renewal.
New accounts start on Free. Paid calls, messages, numbers, and data are available there; Pro and Plus unlock platform features.
Mobile data is pay as you go from the wallet in 0.1 GB steps — there is no prepaid GB pack, and unused wallet credit does not expire. Volume pricing is a marginal ladder inside each rolling 30-day usage period: the price per GB drops as you use more within the same billing period. The period starts in the highest-priced band and later usage in that same period reaches cheaper bands. When the period rolls, the ladder starts again at the expensive band. Usage across countries shares one period total; each country keeps its own live rate. A quoted 5 GB or 10 GB total is for that volume used inside one period, not spread across months. Never derive a per-GB rate by dividing a usage total. There is no usage-triggered Pro charge.

saved-payment-methods

Save a card from Payment methods without topping up. The bank confirms the card (3DS); nothing is charged. Revolut Pay and Apple Pay do not save a card. Top up only when the wallet needs funds.
Open Payment methods from Home tab → Wallet → Payment methods.

widely-announcement

On forwarded SIM calls that land on a shared public forwarding number, callers hear a short Widely ringing message before the phone rings. It does not play on a number the member bought, and it never plays on inbound DID calls.
Free always hears it on the shared number. Pro, Plus, and an active Pro trial can turn it off from the toggle on Receive SIM calls. Free can also skip it by forwarding to their own Widely number, or by porting the SIM number where API port-in is available (UK mobile and Israel).

uk-number-port-in

This is for bringing a number INTO Widely from another provider. If the number is already on the customer’s Widely account and they want to move it away, that is a port-out: the PAC comes from Widely (see uk-number-port-out).
To port a UK mobile number into Widely, text PAC to 65075 from the phone with that SIM. The text is free, the code arrives within a minute, and it stays valid for 30 days.
A PAC works on every UK network under Ofcom. UK mobile port-in is supported in the Widely app, together with Israel mobile port-in.
In-app port-in covers UK mobile numbers and Israel mobile numbers. Landlines and other countries are not offered in the in-app port flow.

uk-number-port-out

When a UK number is on the customer’s Widely account (they ported it in, or bought it from Widely), Widely is that number’s provider. The PAC for it comes from Widely, not from the network they used before.
When the number is not a Widely number (the customer’s own SIM, kept as a verified number for caller ID, and nothing ported in or bought from Widely), Widely is not its provider. It is still with their mobile network, so the PAC comes from that network: for a UK mobile they text PAC to 65075 from that phone (STAC to 75075). It is free and the code comes straight back by text. Signing up to Widely never moves a number; a port-in is optional and the customer starts it. No person is needed for this answer.
Leaving Widely is free: no PAC fee, no port-out fee, no early-exit fee and no cancellation fee. Widely only ever passes on a fee its number supplier charges Widely, and the UK supplier charges nothing for a port-out.
Support gets the PAC with the get_pac tool, for the customer’s own number. The tool requests it from Widely’s UK number supplier. It can take a few minutes, and the customer gets a notification in the Widely app when it is ready. In the in-app Support chat the tool can return the code and its expiry, and Support gives both. On WhatsApp, email or a call the code is shown only in the Widely app, so Support tells them where to open it.
The customer can also get it themselves in the Widely app: Home tab → Calls and messages → Phone numbers → the number → Port out → Get PAC (port out).
If get_pac cannot produce one (failed or not eligible), Support passes the request on in the same chat and the customer gets the PAC there. The customer does not need to contact anyone else. The reply says it plainly ("I've passed on your PAC request. You'll get an answer here in this chat.") and never claims a person will reply.
The customer gives the PAC to their new provider, and the new provider moves the number. A PAC is valid for 30 days.
When the move completes, Widely closes that number’s Widely line: no more monthly renewals and no charge. The number stays on their Widely account as a verified number (it is still theirs, at the new provider), and any caller ID that used it stays, so they can keep showing it on calls from the Widely app.
A port-out does not touch the wallet. Wallet credit belongs to the customer: it stays in their Widely wallet and stays usable for anything else on Widely, and if they close their Widely account the remaining credit is refundable to them.
A PAC request is a request to move the number, not to close the account. Closing the account before the move completes could lose the number, so the PAC comes first.
How a support person handles it: check which of the customer’s numbers they mean, run get_pac, and say plainly that the code comes from Widely and is free. Then say what happens next: the code, where to find it, who to give it to, and what happens to their Widely line afterwards. If they are also upset or complaining, acknowledge it in the same reply and get the PAC anyway.

uk-stac

A PAC moves the number to a new provider. A STAC is for leaving without keeping the number: the new provider uses it to end the old service.
Widely can’t issue a STAC yet. Say that plainly. There is no STAC process, timeline or contact to describe, and no person who issues one, so Support offers the next step instead. get_pac with code_type STAC returns stac_not_available and never contacts the number supplier.
If the customer wants to keep the number, a PAC is what their new provider needs. It comes from Widely, it is free, and Support can get it straight away with get_pac.
To close a Widely number they no longer want, the customer uses the normal path in the Widely app: Home tab → Calls and messages → Phone numbers → the number → Cancel Renewal. The number stays active until the end of the current billing period, then closes. There is no fee for leaving.
Leaving Widely is free: no PAC fee, no port-out fee, no early-exit fee and no cancellation fee. Widely only ever passes on a fee its number supplier charges Widely, and the UK supplier charges nothing for a port-out.
A port-out does not touch the wallet. Wallet credit belongs to the customer: it stays in their Widely wallet and stays usable for anything else on Widely, and if they close their Widely account the remaining credit is refundable to them.
If the customer wants to talk it through, Widely Support is there in the same chat.
How a support person handles it: say plainly that Widely can’t issue a STAC yet, then give the useful next step in the same reply: a free PAC from Widely if they want to keep the number, or Cancel Renewal on the number if they don’t. Say there is no charge for leaving and that they can talk it through with Widely Support if they want.

forwarding-vs-porting

Receive SIM calls (call forwarding) keeps the number with the customer’s current provider and SIM. Calls they forward ring in Widely. Call forwarding carries calls only, so texts to that number keep arriving on the SIM. Widely app permissions do not affect texts that arrive on the SIM.
Porting moves the number itself to Widely. The old provider’s service for that number ends (a contract with them may have its own early-exit charges). After the port completes, calls and texts to the number arrive in the Widely app, and the old SIM stops receiving them.
Signing up for Widely never ports a number. A port only happens when the customer starts one in the app (Phone numbers → add → Port number, or Port on an already-verified line) and enters a PAC from their old provider. Widely then sends a “Your number port is complete” notice when it finishes.
To tell which one a customer has: a completed port request or an active Widely number on their account means the number was ported (or bought). A verified number under Receive SIM calls means forwarding.
A ported number can go back: the customer asks Widely for a PAC and gives it to the old or a new provider, free.
How a support person handles it: look at the account before answering. Say which one the customer actually has, using their dates, in plain words. If they ported and want it back, offer the PAC in the same reply.

mobile-data-line

On a dual-SIM phone, choose the Widely eSIM as the mobile-data line and turn off automatic data switching or cellular data switching when that option exists, so the phone does not fall back to the other SIM for data.
Data Roaming must remain enabled on the Widely eSIM for travel data. Data Roaming and automatic data switching are different settings: roaming stays on for Widely while automatic data switching stays off.
Android labels vary by manufacturer: Settings → SIMs or SIM manager → Mobile data → Widely. On iPhone: Settings → Cellular → Cellular Data → Widely, then turn off Allow Cellular Data Switching.

commercial-qualify

Commercial / partner intent stays on the same Widely Desk bot as Support. Qualify first: who (company they represent + role there), what (an own branded app, connecting a service they already sell, or selling SIM plans on Widely), country, and contact. Do not offer the MCP server or a full branded-operator build.
An own branded app, with their SIP and SMS and the Swiftcom app, starts at https://swiftmobilesolutions.com/white-label.
Connecting a service they already sell starts at https://widely-mobile.com/en/integrate.
Selling SIM plans on Widely starts at https://widely-mobile.com/en/partners.
Who opener EN (exact): Which company should I note, and what’s your role there?
Who opener HE (exact): באיזו חברה אתם, ומה התפקיד שלך שם?
Those who questions mean the company they represent and their role there. Sound human, not a job application or a form. Do not ask which company to register them as.
Ask the next missing qualify question. Do not set needs_human while a qualify question remains askable.
After qualify is complete or genuinely stuck, confirm to the customer, then wake Desk via needs_human with lane=commercial and a structured summary. Do not invent pricing, MSA, SLA, or instant onboard.
Never dump a corporate homepage, FAQ, App Store, Google Play, or in-app Shop for collaborate / שיתוף פעולה / wholesale / operator / a call-meeting-schedule ask. In-app install/activate (SUPPORTWA, eSIM, data-line, other-phone) is Support, not a partner funnel.
A call / meeting / schedule ask on a commercial thread is owned by Desk. Acknowledge it and say they will get an answer about scheduling here in this chat; never say a person or someone from the team will follow up. Do not say you cannot schedule via this channel and dump the corporate homepage, or invent a booking / Calendly / store flow. If qualify is already complete, wake needs_human with lane=commercial.
If the ask is ambiguous collaboration, ask once whether it is for their company or inviting friends. If a live Support issue is also present (frozen wallet, eSIM install, port, billing block), finish that with tools first.
After the qualify-complete ack, stay quiet on commercial until Desk replies, unless the user pivots to a Support issue or asks to schedule a call or meeting.

app-deep-links

Links to Widely app screens use one format: https://webapp.widely-mobile.com/<path>. Take the Absolute URL and the Nav steps from the in-app destinations table (the canonical destinations list). Never build or guess a link, and never use widely-mobile.com/app/ links.
Give a link only when the customer asks where to find something or how to do something, and keep it to one or two links per reply.
How to word it: "Open this link to go straight to the screen in the Widely app: <link>. You can also get there from <Nav steps>."
In the Widely app's Support chat, the link opens the right screen inside the app on iPhone, Android and the web.
In WhatsApp, SMS, email or another AI assistant, the link opens the Widely app but may land on the Home tab instead of the exact screen. So outside the app, always give the menu steps next to the link: "If it opens on the Home tab, go to <Nav steps>."
If the Widely app is not installed, the link opens the Widely web app. If the customer is not signed in there, they sign in first and may then need to follow the menu steps.
Install an eSIM (each eSIM is personal, so there is no shared link): Home tab → Mobile data → open the eSIM → Install.
Bring your number to Widely (port in): https://webapp.widely-mobile.com/did?scope=mine, then tap Bring your number (Home tab → Calls and messages → Phone numbers → Bring your number).
Get a PAC to move a Widely UK number to another network: https://webapp.widely-mobile.com/did?scope=mine, open the number, then the PAC section (Home tab → Calls and messages → Phone numbers → open the number → PAC).

crm-model-limit

CRM model limits follow the plan. Free allows 5 models, Pro allows 15 models, and Plus allows 50 models.
On a connected account the answer also states how many CRM models are used and how many remain.

cancel-pro-auto-renew

To cancel Widely Pro auto-renew in the app (same on web, iOS and Android):
1. Home → Account → Your plan (Membership screen): https://webapp.widely-mobile.com/settings/membership
2. On the Free card, tap Downgrade to this plan.
3. Tap Cancel Membership.
Pro stays active until the end of the paid period, then the account moves to Free. Nothing more is charged for Pro after that.
The Membership screen may still show Renews: <date> after you cancel; that does not mean another charge is coming. Support can confirm the cancellation.
Note: on Free, forwarded calls play the short Widely message. Only Pro can switch that message off.

pull-live-call-between-devices

Widely can move a live call between your devices with "Pull". Works on Android (including Kosher), iOS and the web app.
From the browser to the phone app:
1. Keep the call going in the browser.
2. Open the Widely app on the phone.
3. Open the chat thread with the person you are talking to.
4. On the live call's entry in that thread, tap "Pull". The call moves to the phone and ends in the browser.
From the app to the browser: open the same chat thread in the browser and click the phone icon on the live call's entry ("Pull call to this device"). Works while the call is ringing, calling or answered.
If the button doesn't appear: incoming calls ring on all your signed-in devices, so you can simply answer on the phone.

pull-live-call-between-devices:he

ב-Widely אפשר להעביר שיחה פעילה בין המכשירים שלך עם כפתור Pull. עובד באנדרואיד (כולל כשר), iOS ובאפליקציית הדפדפן.
מהדפדפן לאפליקציה בטלפון:
1. השאר את השיחה פתוחה בדפדפן.
2. פתח את אפליקציית Widely בטלפון.
3. היכנס לצ'אט עם האדם שאתה מדבר איתו.
4. ברשומת השיחה הפעילה בצ'אט, לחץ על כפתור Pull. השיחה עוברת לטלפון ומתנתקת בדפדפן.
מהאפליקציה לדפדפן: פתח את אותו צ'אט בדפדפן ולחץ על אייקון הטלפון ברשומת השיחה ("Pull call to this device"). עובד כשהשיחה מצלצלת, בחיוג או אחרי מענה.
אם הכפתור לא מופיע: שיחה נכנסת מצלצלת בכל המכשירים המחוברים, אז אפשר פשוט לענות בטלפון.

mcp-contact-support

A customer's own AI assistant, connected to the Widely MCP, can contact Widely Support with two MCP tools. ask_support posts a message into that user's Support chat in the Widely app (the same chat the Support team already answers in) and notifies the Support team; the message should say what is needed and what was already tried. Widely's automatic Support assistant does not answer these messages: a person on the Support team reads and replies in that chat, so the reply is not instant. read_support returns the messages in that user's Support chat, oldest first, so the AI can check later for the reply. The user also sees the AI's message and the reply in the Support chat in the Widely app, and can reply there too. Both tools use the existing MCP connection and work from any connected account; if more than one account is connected, the AI must say which account (its id or name). For general product questions without signing in, the AI can use search_help.

ai-answer-when-unanswered

Can a declined or unanswered call go to an AI instead of plain voicemail? Partly.
What works: the AI Personal Assistant can take the call instead of the voicemail beep. Set "When I decline" and "When I do not answer" to Voicemail, then in Voicemail choose the greeting type "AI Personal Assistant". Declined and unanswered calls then reach the assistant, which has a short conversation with the caller (under a minute), takes a message and sends it to you as text. It takes messages only; it does not answer questions from your business knowledge. It needs Widely Pro or Plus.
Ring time: "Ring duration" can be set from 15 to 60 seconds in steps of 5, so 60 seconds is supported. The no-answer action runs when it ends.
Where: open https://webapp.widely-mobile.com/settings/call-management/incoming/me (Home tab → Calls and messages → How I answer) for "When I decline", "When I do not answer" and "Ring duration". Voicemail greeting: https://webapp.widely-mobile.com/settings/voicemail (choose AI Personal Assistant, then Configure Personal Assistant for its name, voice, language and pronouns).
What does not work yet: the AI receptionist (a Plus feature) cannot be the fallback after a decline or after ringing. A receptionist can only be set as the number's own route, so it answers every call straight away, or as the route for closed hours using opening hours. Call queues also cannot overflow to a receptionist.
To have the AI receptionist answer every call on a number, open the number and set Routing → Route to → "AI receptionist or phone menu" (older app versions show "IVR (AI Phone Menu)" or "Phone menu"), then pick the menu: Home tab → Calls and messages → Phone numbers → the number → Routing. The receptionist then answers straight away and your phone does not ring first; it can pass callers on to people or queues if the menu is set up to. Opening hours can send only out-of-hours calls to it. This needs Plus.
Voices: the AI receptionist and the AI Personal Assistant use the same ten voices: Alloy, Ash, Ballad, Cedar, Coral, Echo, Marin (the default), Sage, Shimmer and Verse. You can also use a custom voice you made in the app. The app does not label voices as male or female, so tell the customer to listen and choose: the Personal Assistant screen has a voice preview. The receptionist's voice is picked in Receptionist & phone menus (https://webapp.widely-mobile.com/settings/phone-menus) → the menu → Voice. The speaking language is set separately.

mcp-personal-assistant

What can a customer's own AI assistant do with Widely through the MCP for personal-assistant work? Calls on the user's behalf: request_speak dials a number and Widely's assistant handles the task (task text up to 500 characters; Plus plan); it returns a call_id, and get_call / get_transcript give the outcome and text (empty transcript = still in progress); connect_user true asks the other side to hold and rings the user in. request_call rings the user's phones first, then dials out so the user speaks (Pro). Incoming calls: set_number_routing can point a number at the personal assistant, a receptionist, voicemail and more; the AI Personal Assistant voicemail greeting takes messages from declined or unanswered calls (see guide:ai-answer-when-unanswered). Texts: send_message sends SMS or a Widely message (Pro); search_messages reads Widely, SMS and WhatsApp threads; sending WhatsApp is not an MCP tool. Voicemail: list_voicemails and get_voicemail (transcript; audio link on Pro and above). Missed calls: search_calls. Notifications: subscribe_events sets an https webhook for call.started, call.ended and speak.completed. Contacts: search_contacts. Not available as MCP tools today: reminders, scheduled calls, conference calls, live call translation; requests can go in via submit_product_note.

ai-call-assistant-name

When your AI assistant makes a phone call for you (an AI call or an Errands call requested from ChatGPT, Claude or another AI connected to Widely), it introduces itself with the name set in your Widely AI assistant settings. It never invents a name. The AI that asks for the call can use a different name for one call (assistant_name in the call brief), and can save that name as your default (save_as_default) or set it directly with the set_assistant_name tool. If there is no name in the brief and no assistant settings on your account, the call is refused with a message asking for a name to be set first. To see or change the name yourself: open https://webapp.widely-mobile.com/settings/pa-agent, or in the app go to Settings, then Voicemail, then Configure Personal Assistant, and edit "Assistant's name". The same screen sets its voice, language and pronouns.
Calls are made from a structured brief only: who to call, the goal, who it is on behalf of, the purpose and what counts as success. A free-text request is refused with the list of fields to fill in.
If the call reaches voicemail, the default is to leave a short message. The brief can give the message; otherwise the assistant composes a short one from the goal and who it is calling for, without sensitive details. The brief can instead choose to hang up and try again later (within the allowed time window) or just hang up.
The assistant agrees only to things listed in the brief as allowed commitments. For anything else it says it will check and come back, and the call report lists it as needing your approval.
A call can be scheduled up to 14 days ahead, and a time window must be at least 10 minutes long. It ends each call with a short thank-you and goodbye.
Before the first AI call or Errands call, you accept the Errands terms once. Until then every call is refused with a message saying the terms need accepting, and nothing is dialled. You can accept in two ways: ask the AI you are using (it calls the accept_errands_terms tool, shows you a short summary and a link to the full terms, and records your acceptance only after you agree), or in the Widely app go to Settings, then Voicemail, then Configure Personal Assistant, then Errands terms, and tap Accept. You only need to do this once; if the terms change you will be asked again.

pa-whatsapp-number

Widely Personal Assistant (PA): message it on WhatsApp at https://wa.me/447366629673 (+447366629673). Messages from your verified Widely number go straight to your own PA, no PIN needed. You can also call that number; a plain phone call asks for your voice PIN. Unknown numbers get sign-up instructions. Don't use +447877329241 for this; that number is only for SIM call diverts.

whatsapp-welcome-card

The WhatsApp welcome card is the interactive Widely list sent when a WhatsApp sign-up finishes. The header is Widely and the button is Choose. It is the same menu a new WhatsApp sign-up gets, for a new account and for an existing number that signs up on the WhatsApp line. An in-app signup that never opened WhatsApp does not get this card.
Open Widely: on iPhone this opens the App Store, then a one-time Open Widely link that signs the phone in. On Android it is a Play Store link with a one-time login token in the install referrer. The token is single-use. Do not forward the message.
Get a travel eSIM: opens a destination list, then the app.
My number: opens the Widely number in the app.
My personal assistant: opens the assistant in the app.
Invite friends: opens the invite screen in the app.
Connect an AI agent: offers calls, errands, a travel eSIM, and texts, then a connect link to paste into the assistant.
A vote row appears only while a configured vote is still open. It opens the vote page.
The customer can ask for the card again in the WhatsApp chat, and Support can send it for that user or conversation.
The card goes out only inside the 24 hours since the customer last messaged Widely on WhatsApp. Outside that window a template is needed. The welcome card is not a template and is not sent. A user with no WhatsApp number cannot be sent the card.

android-calls-background

The Widely app on Android is meant to ring from a push notification even when the app is closed. A delay before the ring is being investigated.
While that is checked, confirm these settings on the phone:
Set the Widely app battery to Unrestricted: Settings, Apps, Widely, Battery, Unrestricted.
Enable Widely under Calling accounts (Phone settings, Calling accounts, Widely on).
Allow full-screen notifications for Widely so an incoming call can show over the lock screen.
If calls are still late after those are set, contact Support in this chat.

agent-link-lifetime

The Widely Agent Link is one-time. The link (https://api.swiftcom.cc/agent/<secret>) only asks the account owner to approve the connection, on WhatsApp or in the support chat; the owner has 24 hours to approve, and a later visit asks again. An emailed six-digit code is used only when the connection was set up with an agent email address; links minted without an address send no code. After approval, the first real open of the link shows a long-lived agent token once (it starts with wat_). The agent must store it securely and paste it at https://api.swiftcom.cc/agent from then on. Opening the link again shows 'Link already used'; link previews do not use it up. The token lasts while the connection stays active: each successful agent action moves the expiry to 30 days from then, with no absolute maximum. Opening the link or the page without acting does not extend it. After 30 days with no activity the connection expires and its token is revoked; the next visit asks the owner to approve again, and a new link and token are needed. Going over an action limit (for example 20 changing or paid actions an hour) pauses the connection and sends a new approval request to the owner. Lookups have their own higher limit, which only slows the agent down. The owner can revoke the connection or generate a new link from Integrations in the app. Both cancel the old token straight away; a new link needs approval again.

using-more-than-one-widely-account-with-a-connected-ai

A connected AI (ChatGPT, Claude, Cursor and similar) only sees the Widely accounts you allowed when you connected it. To see which accounts it can use, ask it to call get_account without picking an account; if more than one is connected it lists their names, then pass the account name on later tools. If the tools have no account field, the connection has only one account. To add another: disconnect Widely in the AI app and connect again, ticking every account the AI should use on the Widely approval screen, or in the Widely app open Connected apps, open that AI and add the account. Then ask the AI to refresh its tools.

set-the-apn-for-your-widely-esim-android-iphone-e4f4c0

If mobile data doesn't work with the Widely eSIM installed and roaming on, the phone may be missing the right APN.
Android: In Widely open the eSIM, then Fix data connection; the screen shows the APN. Tap Install APN if offered; if the app can't set it, it copies the APN and opens Access point names. Or go to Settings > Connections > Mobile networks > Access point names, select the Widely eSIM, then Add. Name: Widely. APN: the value shown in the app for your SIM. Leave username and password empty. Save, select it, turn Wi-Fi off and check again.
iPhone: Settings > Mobile Data > [Widely line] > Mobile Data Network, set the APN to the value shown in the app for that SIM, leave username and password blank, and turn on Data Roaming.
Always use the value shown in the app for that SIM.

Live data pricing

Browse live rates for every country.

Cost of one usage amount, as an ordinary page: https://widely-mobile.com/en/pricing/{country_slug}/{gb}gb.

Exact path-based estimator: https://widely-mobile.com/api/pricing/public/data-estimate/{country_code}/{currency}/{gb}.

Data is pay as you go from the wallet in 0.1 GB steps. Installing an eSIM is unpaid; add wallet credit first. Unused wallet credit does not expire. Volume pricing is a marginal ladder inside each rolling 30-day usage period: the price per GB drops as you use more within the same billing period. The highest-priced band is consumed first, then usage in that period advances toward lower-priced bands. When the period rolls, the ladder starts again at the expensive band. The period total is shared across countries, while each destination keeps its own live rate. A quoted GB total is for that volume used inside one period, not spread across months. Never derive a per-GB rate by dividing a usage total. There is no usage-triggered Pro charge. Every live destination is listed at the country index and in the pricing sitemap.

Live pricing URLs you can open directly:

Every country and amount is listed in https://widely-mobile.com/pricing-sitemap.xml.

Use cases

Job pages a retriever can open: https://widely-mobile.com/en/use.

Travel data eSIM — I need travel data without buying a country pack that expires.
Receive SIM calls — People call my mobile SIM number and I want it to ring in an app on every device.
Local number — I need a local phone number so family abroad can dial locally while I answer in an app.
Office phone system — I need a cloud PBX for an office of any size: an IVR or AI agent to answer, then a queue, and staff calling from mobiles with the office number as caller ID.

Comparisons and alternatives

Named pages a retriever can open: https://widely-mobile.com/en/compare.

Auth and CRUD

Authorization: Bearer <access_jwt>. Issued at login. JWT identity is User.id — never use it as consumer_user_id.
Authorization: Bearer pk_live_<hex> (or pk_test_). Create keys via CRUD ApiKey; the full key is shown once. Hashed at rest (key_hash is never returned).
Every consumer-scoped request must pass consumer_user_id or consumer_id as a query param (and in JSON bodies that mutate). The server does not infer CU from the JWT.
Generic entity routes: GET/POST /api/<entity>/ and GET/PUT/DELETE /api/<entity>/<id>. Entity name is lowercased (SipTrunk → /api/siptrunk/). Nested members use ?include= or model_api_includes defaults. Writes that charge money need confirm + quoted_charge (never a single tap).
409 {"error":"platform_upgrade_required", ...} when a Free account hits a Pro/Plus capability. Open in-app membership — do not send users to the marketing site to pay.
A consumer User PATCH can return 200 and store nothing for restricted fields. Profile writes go through PUT /api/user_routes/update-profile; identity email/phone are OTP-owned.

SIP trunk / PBX integration

Create a SipTrunk via POST /api/siptrunk/ (name, ip_address of your PBX, port, transport_protocol, channel_count ≥ 2).
Or create it in the app: Connectivity → SIP trunks.
Point the PBX at sip.swiftcom.cc port 5060 (UDP unless the trunk says otherwise).
Use sip_username / sip_password from the create response when registration_mode needs credentials. ip_only trunks authenticate on source IP.
Extra concurrent channels are an account SIP channel pack: GET /api/membership/sip-channel-pool/quote then POST with confirm=true and quoted_charge.
Do not invent per-minute trunk pricing — the pipe is channel-based; calls remain PAYG on the wallet.

In-app destinations

Profile — Your name, email, and password — Home tab → Profile
Wallet — Your balance and top-up — Home tab → Wallet
Ready to travel — Check your eSIM, SIM calls, and credit before you fly — Home tab → Ready to travel
eSIMs — Data eSIM, or a local eSIM with a number — Home tab → eSIMs
Receive SIM calls — Set up a number here so calls to your SIM phone ring in Widely. — Home tab → Receive SIM calls
Calls and messages — How you answer, call, and message — Home tab → Calls and messages
Account — Company, users, calls, your plan, and providers — Home tab → Account
App — Language, appearance, notifications, privacy, about — Home tab → App
Help & Support — How-to guides, FAQs, and chat with Widely — Home tab → Help & Support
Widely Partner Interconnect — Connect your numbers and SIP trunks to Widely — Home tab → Widely Partner Interconnect
{{appName}} Hub — Customers, money, and campaigns — Home tab → {{appName}} Hub
Language — The language used in the app — Home tab → App → Language
Appearance — Follows your phone’s light or dark mode — Home tab → App → Appearance
Notifications — Which alerts you get, and where they are sent — Home tab → App → Notifications
Privacy — Presence, read receipts, and blocked contacts — Home tab → App → Privacy
Audio & video — Microphone and speaker for calls — Home tab → App → Audio & video
About — Version, updates, and how to reach Support — Home tab → App → About
Developer — Logs and which server this app uses — Home tab → App → Developer
OS App Settings — Permissions in your phone settings — Home tab → App → OS App Settings
Account — Company details — Home tab → Account → Account
Users — Who can use this account — Home tab → Account → Users
Family location — See where family phones are, set places and alerts — Home tab → Account → Family location
Calls — Account numbers, routing, schedules, and connectivity — Home tab → Account → Calls
Account activity — Who changed this account — Home tab → Account → Account activity
Your plan — Free, Pro, or Plus for this person — Home tab → Account → Your plan
Connected apps — AI assistants allowed to read this account — Home tab → Account → Connected apps
Providers — Carriers and services this account pays — Home tab → Account → Providers
Investor relations — Your share allocation and agreement — Home tab → Account → Investor relations
Invite friends — A link friends can use to join — Home tab → Account → Share → Invite friends
Rates — Home tab → Calls and messages → Rates (top right)
Phone numbers — Numbers assigned to you — Home tab → Calls and messages → Phone numbers
How I answer — Ring time, voicemail, and missed calls — Home tab → Calls and messages → How I answer
How I call — Caller ID and calling people who are offline — Home tab → Calls and messages → How I call
How I message — SMS delivery when you are offline — Home tab → Calls and messages → How I message
Desk phone SIP details — This user’s SIP username, password, and registered devices — Home tab → Calls and messages → Desk phone SIP details
Phone numbers — All numbers, assignments, and Caller ID access — Home tab → Account → Calls → Phone numbers
Incoming — Routing rules, receptionists and phone menus, on hold, caller lists, and SIM calls — Home tab → Account → Calls → Incoming
Outgoing — Call routes and outbound routing rules — Home tab → Account → Calls → Outgoing
Connectivity — eSIMs, SIP, SMS, VPN, and API connections — Home tab → Account → Calls → Connectivity
Call services — Recording, transcription, and storage — Home tab → Account → Calls → Call services
Broadcast lists — Saved groups of message recipients — Home tab → Account → Calls → Broadcast lists
Schedules — Hours for incoming and outgoing routing — Home tab → Account → Calls → Schedules
Speed dials — Short codes that ring people on this account — Home tab → Account → Calls → Speed dials
Emergency routing — 999, 911, and other short codes for every outbound call — Home tab → Account → Calls → Emergency routing
Termination — Used when the caller left Call route unset. Each feature is taken from the first matching rule that sets it. — Home tab → Account → Calls → Termination
Core sites — HSS and HLR sites the DRA and STP use — Home tab → Account → Calls → Core sites
Core fabric — DRA and STP addresses — Home tab → Account → Calls → Core fabric
Routing rules — First matching rule wins. Number defaults apply if none match. — Home tab → Account → Calls → Incoming → Routing rules
Receptionist & phone menus — What the caller hears and where they go — Home tab → Account → Calls → Incoming → Receptionist & phone menus
On hold — People, overflow, and music — Home tab → Account → Calls → Incoming → On hold
Live call center — See the calls that are waiting and sign in to answer them — Home tab → Account → Calls → Incoming → Live call center
Number lists — Allow or block callers — Home tab → Account → Calls → Incoming → Number lists
Call routes — Named lists of trunks and how they are chosen — Home tab → Account → Calls → Outgoing → Call routes
Routing rules — When to record, change Caller ID, or pick a call route — Home tab → Account → Calls → Outgoing → Routing rules
Transcription — Manage plan, minutes, auto-transcribe, and call recording transcription — Home tab → Account → Calls → Call services → Transcription
Call recording — Choose when to record and manage stored calls — Home tab → Account → Calls → Call services → Call recording
SIP trunks — Connect a carrier or office PBX — Home tab → Account → Calls → Connectivity → SIP trunks
SMS trunks — Connect API (HTTP), SMPP, or SIP MESSAGE — Home tab → Account → Calls → Connectivity → SMS trunks
SMS routes — Named lists of SMS trunks of any type — Home tab → Account → Calls → Connectivity → SMS routes
VPN tunnels — Secure private connectivity to Widely — Home tab → Account → Calls → Connectivity → VPN tunnels
API keys — Credentials for your systems — Home tab → Account → Calls → Connectivity → API keys
Connection Status — OPTIONS reachability and Widely backup — Home tab → Widely Partner Interconnect → Connection Status
Carrier numbers — Partner DID inventory — not charged — Home tab → Widely Partner Interconnect → Carrier numbers
Routing rules — Destinations to interconnect trunks — Home tab → Widely Partner Interconnect → Routing rules
Call routes — Named lists of interconnect trunks — Home tab → Widely Partner Interconnect → Call routes
SMS routes — Named lists of interconnect SMS trunks — API, SMPP, or SIP — Home tab → Widely Partner Interconnect → SMS routes
SIP trunks — Sends your calls to Widely — Home tab → Widely Partner Interconnect → SIP trunks
SMS trunks — API (HTTP), SMPP, or SIP MESSAGE interconnect — Home tab → Widely Partner Interconnect → SMS trunks
IPsec — Private connectivity for SMPP, Diameter, and MAP — Home tab → Widely Partner Interconnect → IPsec
Diameter peers — Your DRA or MME — Home tab → Widely Partner Interconnect → Diameter peers
MAP links — Your M3UA association — Home tab → Widely Partner Interconnect → MAP links
Signaling routes — Which prefix uses which peer — Home tab → Widely Partner Interconnect → Signaling routes
Dashboard — Customers, money, and what needs attention — Home tab → {{appName}} Hub → Overview → Dashboard
Customers — Accounts that buy services from you — Home tab → {{appName}} Hub → Customers and growth → Customers
Campaign invites — Links that track which ad or placement signed people up — Home tab → {{appName}} Hub → Customers and growth → Campaign invites
Payment connections — Revolut, Stripe, and TrueLayer — Home tab → {{appName}} Hub → Payments → Payment connections
Services — What you sell — Home tab → {{appName}} Hub → Products and pricing → Services
Call price lists — What customers pay for calls — Home tab → {{appName}} Hub → Products and pricing → Call price lists
SMS price lists — What customers pay for messages — Home tab → {{appName}} Hub → Products and pricing → SMS price lists
Data rates — Estimate the cost of mobile data — Home tab → eSIMs → Data rates (top right)
Caller ID — The number and name others see — search "Caller ID" on Home
Voicemail — Greeting and messages callers leave — search "Voicemail" on Home
Auto top-up — Add money when the balance gets low — Home tab → Wallet → Auto top-up
Top up — Add money to the wallet — Home tab → Wallet → Top up
Payment methods — Saved cards for membership and top-up — Home tab → Wallet → Payment methods
Subscriptions — Membership, numbers, and other renewals — Home tab → Wallet → Subscriptions
Payments — Top-ups, credits, and payments — Home tab → Wallet → Payments
Invoices — Monthly invoices and email delivery — Home tab → Wallet → Invoices

Entities

Account /api/account/ [list,get,create,update,delete]
ApiKey /api/apikey/ [list,get,create,update,delete]
BroadcastList /api/broadcastlist/ [list,get,create,update,delete]
CallQueue /api/callqueue/ [list,get,create,update,delete]
CallerID /api/callerid/ [list,get,create,update,delete]
ConsumerUser /api/consumeruser/ [list,get,create,update,delete]
ConsumerUserInvite /api/consumeruserinvite/ [list,get,create,update,delete]
DID /api/did/ [list,get,create,update,delete]
Extension /api/extension/ [list,get,create,update,delete]
IVRConfig /api/ivrconfig/ [list,get,create,update,delete]
LCR /api/lcr/ [list,get,create,update,delete]
LCRTrunk /api/lcrtrunk/ [list,get,create,update,delete]
Rate /api/rate/ [list,get,create,update,delete]
RateSheet /api/ratesheet/ [list,get,create,update,delete]
RoutingRule /api/routingrule/ [list,get,create,update,delete]
SharedTrunk /api/sharedtrunk/ [list,get,create,update,delete]
SipTrunk /api/siptrunk/ [list,get,create,update,delete]
TimeGroup /api/timegroup/ [list,get,create,update,delete]
User /api/user/ [list,get,create,update,delete]
VerifiedNumber /api/verifiednumber/ [list,get,create,update,delete]

Custom routes

GET /api/membership/plans — Per-user platform tiers and capabilities for the signed-in account
GET /api/membership/plans/public — Public Free/Pro/Plus cards (no session)
POST /api/membership/upgrade — Upgrade platform tier; debit the Consumer wallet
POST /api/membership/downgrade — Schedule a tier downgrade at period end
GET /api/membership/sip-channel-pool — Shared SIP channel pack capacity for the account
GET /api/membership/sip-channel-pool/quote — Read-only price for a SIP channel pack change
POST /api/membership/sip-channel-pool — Commit SIP pack change: confirm=true plus quoted_charge echo
GET /api/membership/channel-quote — Read-only price for extra DID channels
GET /api/balance_and_payment_routes/get-balance — Wallet non_spent_balance / wallet_total (spendable + frozen) and currency
GET /api/pricing/public/data-rate-card — PAYG eSIM rate card using the 30-day marginal usage ladder (not a flat first-GB rate)
GET /api/pricing/public/data-estimate/{country_code}/{currency}/{gb} — Exact path-based PAYG data estimate for a country, currency, and decimal GB amount
POST /api/pricing/public/data-estimates — Bounded exact PAYG estimate matrix for up to 20 countries and 5 GB amounts
GET /api/pricing/public/countries — Server-rendered live country data-pricing index
GET /api/pricing/public/country/{country_slug} — Server-rendered live rates and 1/3/5/10/20/50 GB totals in all public currencies
GET /api/pricing/public/country/{country_slug}/{gb_slug} — Server-rendered total cost for one country and one usage amount in every public currency; gb_slug looks like 5gb or 3-7gb. Linked as /en/pricing/{country_slug}/{gb_slug}
POST /api/pricing/public/estimate-data-cost — Estimate PAYG data cost for country + GB
POST /api/pricing/public/check-call-rate — Indicative per-minute call rate
GET /api/pricing/public/did-rates — Indicative DID monthly/setup rates
POST /api/voip/check-call-rate — Signed-in rate checker (same engine as the app)
POST /api/sim_orders/sims/purchase — Provision a PAYG eSIM (wallet debit; install-first / platform cap apply)
POST /api/call_forwarding/setup_call_forwarding — Start Receive SIM calls for a verified number
POST /api/call_forwarding/test_forwarding — Place the verification call used to prove SIM forwarding