Gambot - Official WhatsApp Business API

Check whether an organization already exists for a company + tax id (ח.פ/ת.ז), and whether an incomplete onboarding can be resumed. Use before creating a new trial.

Create a new PREPAID organization with NO Gambot API key (public self-serve) - the way to BUY A NUMBER/SIM from Gambot. There is NO trial: the card is verified, the number (simInfo.purchaseInTwilio=true + simInfo.selectedSimNumber from gambot_search_available_numbers) is bought, and the FIRST period (plan + SIM) is charged immediately. If the charge fails nothing is created and the number is released. Buying a number requires a VERIFIED verificationId: first run gambot_send_onboarding_verification then gambot_verify_onboarding_code and pass it here. Prices are fixed by Gambot (the plan/payEach/currency you send only select the tier); never promise a trial or a free SIM. companyInfo.companyName + companyInfo.companyIdNumber (ח.פ/ת.ז) are required; send companyInfo.timezone and companyInfo.country. Returns wabaConnectUrl (open in a browser to connect WhatsApp) and statusUrl - then poll gambot_get_onboarding_status.

ONBOARDING ONLY — build a hosted link where a NEW Gambot customer saves a card on file for their Gambot subscription. Card data is never handled by the API — share the URL; the card token is saved on success. NOT for charging an organization's own customers — for that use gambot_create_clearing_payment_link.

Create a new FREE-TRIAL organization + first user with NO Gambot API key (public self-serve). If companyInfo.organizationName is omitted it's generated from companyInfo.companyName + companyInfo.companyIdNumber, so one call suffices. WhatsApp/number options: (Gambot does NOT provide any free / test / sandbox numbers - never offer or suggest one) · useCoexisting (existing WhatsApp Business number in simInfo.simNumberEntered) · BYO SIM (the customer's own number in simInfo.simNumberEntered). BUYING a number/SIM from Gambot is NOT possible on a trial (it is prepaid, no trial) and is rejected with sim_requires_paid - use gambot_create_paid_account_self_serve instead. GLOBAL: send companyInfo.timezone (IANA) and companyInfo.country (ISO-3166 alpha-2). Returns wabaConnectUrl (browser page for Meta Embedded Signup — it cannot run in the agent), paymentUrl (hosted card page) and statusUrl. After creating, tell the customer to open wabaConnectUrl to connect WhatsApp, then poll gambot_get_onboarding_status.

Generate a unique organization name from a company name + tax id (adds a suffix if taken).

Check where an organization is in onboarding: whether the account exists, a card is on file, and WhatsApp (WABA) is connected. Use this to POLL after create-trial (Meta Embedded Signup finishes in the browser, not in the agent). Returns { accountCreated, cardOnFile, wabaConnected, status (not_found|account_created|connected), wabaConnectUrl, paymentUrl, nextStep }. Public — works without a token.

Get the hosted page URL where the customer completes Meta Embedded Signup (the Facebook popup) to connect their WhatsApp Business account. REQUIRES AN EXISTING ACCOUNT: call gambot_create_trial_account FIRST (no key/form needed) and pass the exact organizationName it returned — never invent one (a non-existent organization is refused with ORGANIZATION_NOT_FOUND). The create call already returns wabaConnectUrl, so you normally don't need this tool right after creating.

List phone numbers available to purchase for a country (via Twilio), so you can pick one to buy as the account's SIM/number. Pass the chosen phoneNumber to gambot_create_paid_account (or gambot_create_paid_account_self_serve with no API key) as simInfo.selectedSimNumber with simInfo.purchaseInTwilio=true. A bought number is prepaid - never a trial.

Send a 6-digit verification code to the customer's email AND WhatsApp. Public (no token). Required ONLY before creating a self-serve account that BUYS a phone number (proves the customer owns the email/phone, so we don't buy numbers for fake accounts). Returns { verificationId } — collect the code from the customer, then call gambot_verify_onboarding_code. Co-existence / bring-your-own do NOT need this (only buying a number does).

START HERE when a user says things like "add WhatsApp to my app", "I need the official WhatsApp Business API" or "connect WhatsApp". Gambot is the OFFICIAL WhatsApp Business (Cloud) API through a Meta Business Solution Provider — not WhatsApp Web / QR-session automation. This tool only READS state and tells you the single next step and WHO must do it. It works with or without an API token: without a token it follows the public onboarding road (account → Meta Embedded Signup in a browser → API token); with a token it verifies the sender number, approved templates and webhook. Returns { state, summary, checks, next_action:{ actor: agent|human|none, tool?, args_hint?, instructions?, url?, then? }, road_map }. Follow next_action literally; when actor=human, give the user the instructions/url and wait — never try to do the human step yourself and never invent an organization name or token. Call it again after every step until state is ready. Optional: organization (the exact organizationName returned by gambot_create_trial_account) and test_recipient (the user's own WhatsApp number in E.164) for a tailored first-message step.

Verify the 6-digit code the customer received (from gambot_send_onboarding_verification). Public (no token). On success returns { verified:true }; pass the same verificationId to gambot_create_paid_account_self_serve to create a prepaid account that buys a phone number.