Widely Mobile

Canonical machine-readable spec: JSON · OpenAPI · Markdown · llms.txt. Brand-domain JSON: https://widely-mobile.com/widely-knowledge.

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 Business) 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 Business are platform capability plans. New accounts start Free. Membership belongs to each user, so one account may mix Free, Pro, and Business people. Add as many users as needed. The account owner must be Business for shared PBX objects such as phone menus, queues, and shared numbers to operate; each queue agent and shared-number user must also be Business.
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 Business, Widely can be the office phone system: 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 Business monthly prices are public. Changing the plan finishes in Widely. A ChatGPT or Claude directory connection does not charge for the plan.
Business 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 Business. 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 Business 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.

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 Business 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 Calls included. Both options are visible on Free, Pro, and Business.
Choosing Number only does not require Pro. The first active number is available on Free; the platform number limit applies when adding more numbers.
Every platform tier pays the same published retail price for either phone-number option. Free, Pro, Business, trial, and staff are not moved onto a cost-plus floor when a sticker exists.
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 Business 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, Business, 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).

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"). עובד כשהשיחה מצלצלת, בחיוג או אחרי מענה.
אם הכפתור לא מופיע: שיחה נכנסת מצלצלת בכל המכשירים המחוברים, אז אפשר פשוט לענות בטלפון.

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/Business 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 Business 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, phone menus, queues, 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
Phone menus — What the caller hears and where they go — Home tab → Account → Calls → Incoming → Phone menus
Call queues — Who rings, overflow, and music — Home tab → Account → Calls → Incoming → Call queues
Live call center — See live calls and sign in to queues — 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/Business 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