SMS Aero
SMS Aero Integration

Send SMS, WhatsApp and Viber and check delivery right in the chat

Connect SMS Aero to the AI agent: SMS delivery, message statuses, sender signs and balance. The agent estimates campaign cost and lists undelivered messages.

How the agent works with SMS Aero Integration

The agent calls the SMS Aero gateway at https://gate.smsaero.ru/v2 and works with what that API can do: sending to a number or to a whole list at once, the history of what went out, the status of every message, groups and contact cards, the blocklist, checks on whether a number is live and which operator it belongs to, the balance and the tariff, plus the separate WhatsApp, Viber and Telegram-code channels. A bulk campaign goes out as one request carrying the list rather than a loop of single sends, so there is no such thing as a half-sent campaign.

The price is counted in parts: a long text is split into several messages, each charged separately, Cyrillic shortens a part more than Latin does, and mixing Cyrillic and Latin inside a single word is refused outright. The API does not return the number of parts, so the agent works it out from the length of the text itself and takes the price from a test send — which returns the cost without charging you and without reaching the subscriber.

Sending spends money and reaches other people's phones, so the agent never launches it on its own. First it shows the text, the sender sign, the size of the list and the price, and only after you confirm does it go ahead. Then it collects the result for each number separately and puts the numbers the message never reached into a list of their own — with the reason for the refusal, not a generic error phrase. It treats the irreversible the same way: wiping every group or contact and topping the balance up from a card happen only on an explicit confirmation.

A status does not arrive at once or in a single step: without a contract every message goes through manual moderation for up to ten minutes, and «in moderation» is a normal state rather than a fault. «Handed to the operator» is not the same as «delivered» either, so the agent re-reads the status later instead of passing one off as the other. A sender sign may be approved by some operators and not others — the agent reads the per-operator breakdown and warns when the campaign will bounce for part of your audience.

The gateway issues no separate token: every request is signed with the pair of values from the cabinet, so reissuing the key cuts access off instantly — and the agent says straight away that the connection has to be refreshed instead of retrying in silence. When the cabinet has an IP allowlist switched on, the service answers with a refusal that reads a lot like «no data» — the agent names the real reason instead of retrying pointlessly. It reads lists to the end page by page and states any shortage of data or permissions directly.

Integration scenarios

A campaign to a list of numbers

The agent sends your list in a single request with an approved sender sign and returns the result for each number separately.

The price before sending

The agent runs the text as a test request that charges nothing, shows the price per message and the total for the list, and sends only after you confirm.

Delivery statuses

The agent checks the status of every message — delivered, handed to the operator, rejected or still in moderation — and collects the numbers the SMS never reached.

Opt-outs and the blocklist

The agent puts everyone who opted out on the service blocklist and keeps them out of later campaigns, and puts a number back when you ask.

Groups and contacts

The agent builds a group of recipients, adds contacts with a name and a field for substitution, and later sends to the whole group instead of listing numbers by hand.

Live numbers before a campaign

The agent orders an HLR check and shows which numbers are reachable and which do not exist, so you do not pay to send into the void.

WhatsApp, Viber and Telegram codes

The agent sends a message over WhatsApp or Viber, pulls up the conversation in a dialog, and delivers a confirmation code via Telegram with a fallback to SMS if it does not arrive.

Balance and tariff control

On a schedule the agent checks the balance against the price on your tariff and warns in advance when the funds will not cover the next campaign.

SMS Aero Integration examples

SMS Aero
SMS Aero Integration
Frozen chats — click a question
Прикинь смету на SMS по базе

2 140 номеров, текст в 2 части — 8 988 ₽, на балансе 12 400 ₽.

Прогнал тестовым запросом без списания, подпись SHOPNAME одобрена. Если убрать ссылку с utm, текст влезет в одну часть и выйдет вдвое дешевле — сократить?

How to connect

Before you connect

  • A company account on smsaero.ru — its email is the API login.
  • A topped-up balance — the service is prepaid.
  • A sender name that has passed moderation — unapproved names are rejected.
  1. 1

    Sign in to your SMS Aero account

    Open smsaero.ru/cabinet and sign in with the company account. That account's email is the first of the two values you need: it doubles as the API login.

  2. 2

    Copy the API key from settings

    Settings → "API" (smsaero.ru/cabinet/settings/apikey). The key only works paired with the account email, so copy both values.

FAQ

With the account email and an API key from the workspace: Settings, then API on smsaero.ru. The key works only paired with the email. A sender name (sign) in the connection is optional — it can be passed per send — but either way the sign has to pass moderation.

The history of sent messages and the status of each, the balance and the tariff, sender names with their moderation status, groups and contact cards, the blocklist, HLR results and the operator behind a number, plus WhatsApp dialogs and messages.

Sending spends money, so the agent first shows the text, the sign and the price, and goes ahead only after you confirm. The same holds for the irreversible: wiping contacts or groups and topping up the balance.

The service runs on prepayment: when funds are short it replies with a payment error and does not send the message. The agent will show the balance and name the amount that was missing.

Without a signed contract the service reviews every message by hand, which takes up to ten minutes. The agent does not treat that status as an error and re-reads it later; to remove moderation entirely, sign the contract in the «Реквизиты и договоры» section.

Related integrations

Category
Ads
Connection
API key

Connect SMS Aero Integration

Connecting takes a couple of minutes, and your data stays in your own systems.

Connect