Help

Getting started

From registration to the first answered customer — six steps. On first registration you get a one‑month trial with full access.

Connecting channels

Step‑by‑step guides for each channel. Channels are connected per site (widget) in the dashboard, in the “Channels” section; after a channel is saved Smartbtn checks that the platform accepts messages. Messages from every channel arrive in “Conversations”.

Telegram botYou’ll need: a bot from @BotFather, its username and token.6 steps → VK communityYou’ll need: a community access key and the community link or ID.5 steps → MAX botYou’ll need: a verified organisation on business.max.ru, the bot nickname and token.6 steps → WhatsApp Business (Cloud API)You’ll need: a Meta Business app with WhatsApp, a number, Phone number ID, WABA ID and a permanent token.6 steps · about 10 minutes → Avito accountsYou’ll need: an Avito account with a suitable subscription; authorisation via Avito.4 steps → CIANYou’ll need: the “Basic” CIAN plan, the CIAN API key and the account address.5 steps → Facebook MessengerYou’ll need: a long‑lived Page access token and the Page address.5 steps → Viber botYou’ll need: a commercial Viber bot, its URI and token (app key).5 steps → OK groupYou’ll need: an access key and the group dialog link.6 steps → AliExpressYou’ll need: an API token from the AliExpress seller account and the store address or ID.5 steps → Apple Messages for BusinessYou’ll need: a Messages for Business account linked to Infobip, Apple Business ID and an Infobip API key.7 steps → WordPress and other CMSInstalling the widget code on a site built with a CMS.3 steps →

Telegram bot

Customers write to your bot in Telegram, you answer from Smartbtn — the reply arrives in Telegram.

1. Create a bot with @BotFatherIn Telegram open @BotFather, send the /newbot command and set the bot’s name and username. The username must end with “bot”.
2. Copy the tokenBotFather sends a token like 123456:AAH… — copy it completely.
3. Enter the bot usernameIn the dashboard open “Channels”, choose Telegram and enter the bot username without @.
4. Paste the tokenPaste the token into the “Bot token” field.
5. Connect TelegramClick “Connect Telegram”. Smartbtn asks Telegram whether the bot responds — the green mark appears only after its answer.
6. Send /start to the botOpen the bot in Telegram and send it /start. After that it can talk to customers.

VK community

Messages to your VK community come to Smartbtn; replies go back to VK on behalf of the community. You can connect several communities.

1. Create a community access keyIn the community open “Manage” → “Advanced” → “API usage” → “Access tokens” tab → “Create token”. Tick the rights “Community messages”, “Community management”, “Photos”, “Documents” and click “Create”; confirm in the VK app or by SMS.
2. Paste the keyIn the dashboard open “Channels” → VK and paste the key into the “Community token” field.
3. Specify the communityIn the “Community link or ID” field paste the community address (e.g. vk.com/club123456) or its numeric ID.
4. Connect the communityClick “Connect”. Receiving messages (Callback API, message_new event) is configured automatically — nothing else to do.
5. CheckSend a test message to the community — it should appear in “Conversations”.

MAX bot

Messages to your bot in the MAX messenger come to Smartbtn, replies go back to MAX.

1. Create a bot on the MAX partner platformSign in to business.max.ru (or the “MAX for business” mini‑app), create and verify the profile of your organisation, sole proprietor or self‑employed person (available to Russian residents), then in “Chat bots” click “Create”.
2. Fill in the bot cardUpload a logo, set the name and description. The nickname is generated automatically (like idINN_bot). After creation the bot goes through moderation.
3. Copy the tokenAfter moderation open “Chat bots” → your bot → ⋮ → “Settings” and copy the token.
4. Enter the bot nicknameIn the dashboard open “Channels” → MAX and enter the nickname without @.
5. Paste the tokenPaste the token into the “Bot token” field.
6. SaveClick “Save settings”.

WhatsApp Business (Cloud API)

WhatsApp is connected through the official Meta WhatsApp Business Cloud API: one number answers in conversations and sends mailings with approved templates. Set up in the “Connections” section, takes about 10 minutes.

1. Create a Meta appIn Meta for Developers create a Business app (or use an existing one) and add the WhatsApp product.
2. Add the numberWhatsApp → API Setup: add your number (it must not be used in the WhatsApp app), confirm it with a code and wait for the display name approval.
3. Copy the IDsCopy the Phone number ID and the WhatsApp Business Account ID.
4. Create a permanent tokenMeta Business → Settings → System users: create an admin, give it the app and the WhatsApp account, generate a token that never expires with whatsapp_business_messaging and whatsapp_business_management permissions.
5. Save and checkIn the dashboard open “Connections” → WhatsApp, paste the data and click “Save and check”.
6. Turn on incoming messagesClick “Connect automatically” and choose the sites (projects) for replies and mailings.

Avito accounts

Avito chats are connected by accounts: each account is a separate authorisation in Avito, you can add several. An Avito subscription is required: “Maximum” for Goods and Jobs, “Extended” or “Maximum” for Services.

1. Name the accountIn “Channels” → Avito enter an account name (up to 50 characters) — it helps to tell accounts apart.
2. Add the accountClick “Add account” — the Avito authorisation page opens.
3. Allow accessSign in to the right Avito account, check the rights to read and modify messages in the Avito messenger and click “Authorise application”.
4. Manage accountsAdd more accounts or delete unneeded ones — the list is on the same page.

CIAN

Messages from your CIAN account come to Smartbtn.

1. Get the CIAN API keyThe “Basic” plan is required. In the CIAN account open the API section and click “Get API key”.
2. Find the key in your emailCIAN sends the ACCESS KEY to the account’s email. Also make sure receiving messages is enabled in my.cian.ru/settings/chats.
3. Enter the account addressIn “Channels” → CIAN paste your CIAN account address.
4. Paste the keyPaste the key into the “CIAN API key (ACCESS KEY)” field.
5. SaveClick “Save settings”.

Facebook Messenger

Messages sent to your Facebook Page in Messenger come to Smartbtn. Messenger allows free‑form replies within 24 hours after the customer’s message.

1. Choose MessengerIn “Channels” click the Messenger icon.
2. Get the Page tokenGet a long‑lived Page access token following the Meta for Developers guide.
3. Enter the Page addressPaste the Facebook Page address into the “Facebook Page address” field.
4. Paste the tokenPaste the Page token into the “Secret key” field.
5. SaveClick “Save settings”.

Viber bot

Messages to your Viber bot come to Smartbtn.

1. Choose ViberIn “Channels” click the Viber icon.
2. Get a Viber botSince 5 February 2024 Viber bots are created only on commercial terms: apply directly to Viber or via its official partner (developers.viber.com). The token is in Viber: More → Settings → Bots → Edit Info → “Your app key”.
3. Enter the bot URIPaste the bot URI (the same as in viber://pa?chatURI=… links) into the “Bot URI” field.
4. Paste the tokenPaste the app key into the “Bot token” field.
5. SaveClick “Save settings”.

OK group

Messages to your OK group come to Smartbtn.

1. Get an access keyGet the group access key as described in the OK API guide.
2. Choose OKIn “Channels” click the OK icon.
3. Enter the group addressIn the group settings copy from “Direct link to the group dialog” the part like group/58269558636565/messages and paste it into the “Group address” field.
4. Paste the keyPaste the key from step 1 into the “Access key (token)” field.
5. SaveClick “Save settings”. The webhook is registered automatically.
6. CheckSmartbtn shows whether OK confirmed receiving messages. Send a test message to the group — it will appear in “Conversations”.

AliExpress

Buyer messages from AliExpress come to Smartbtn.

1. Open the API tokens pageSign in to the seller account (seller.aliexpress.ru) and open seller.aliexpress.ru/token‑management/active.
2. Create a tokenClick “Create token”, then click the token and copy it.
3. Specify the storeIn “Channels” → AliExpress enter your store address or ID.
4. Paste the tokenPaste the token into the “API token” field.
5. SaveClick “Save settings”.

Apple Messages for Business

Messages from Apple Messages for Business (formerly Business Chat) come to Smartbtn via the Infobip provider: Apple does not give businesses direct access.

1. Register with AppleIn Apple Business Register (register.apple.com) register the organisation and create a Messages for Business account; choose Infobip as the Messaging Service Provider.
2. Link the account with InfobipLink the account with your Infobip account and wait for Apple’s approval — the status becomes ONLINE.
3. Enter the Infobip Base URLIn “Channels” → Messages for Business paste your Infobip Base URL (like xxxxx.api.infobip.com).
4. Enter the Apple Business IDCopy it in Apple Business Register: the Messages for Business account → “Links” → “Copy ID”.
5. Paste the Infobip API keyCreate an API key in Infobip (API key management) and paste it — the Callback URL appears below.
6. Set the Callback URL in InfobipIn Infobip: Channels and Numbers → Channels → Apple Messages for Business → Senders → ⋮ → Edit inbound configurations → Forwarding to HTTP, paste the Callback URL.
7. SaveClick “Save settings”.

WordPress, Tilda and other CMS

The widget is installed with one installation code — it works on any site and CMS.

1. Copy the installation codeIn the dashboard open “Widget” and copy the installation code.
2. Paste it into the siteAdd the code to every page before the closing tag: in WordPress — via the theme (footer.php) or any plugin for inserting code into the header/footer; in other CMS — in the field for custom HTML/JS code.
3. CheckOpen the site — the button appears; further design changes are made in the dashboard without re‑installing the code.

Knowledge base

Will help, suggest, teach. Start typing — the list filters as you type.

smartbtn_widget_api.setContactInfo({
  name: "Alex Morgan",
  email: "email@example.com",
  phone: "+17584987855",
  description: "Description text"
});

smartbtn_widget_api.setCustomData([
  {
    title: "Actions",
    content: "Add contact",
    link: "https://crm.example.com/contacts/new"
  },
  {
    content: "Open customer profile",
    link: "https://crm.example.com/customers/42"
  }
]);

curl -H "Authorization: Bearer <token>" https://<host>/api/v1/chats

// → { "data": [...], "next_cursor": "..." | null }

• Standalone PWA window without browser address bar, with Dock badge and Web Push notifications
• Instant access to all tools: WhatsApp, Telegram, Instagram, Messenger, AI co‑pilot, chatbot, callback, Directions, Price
• Push notifications for new messages and callback requests
• Operator monitoring, SLA timers and statistics — right in the app

Contact us

Have a question or a suggestion? Write to us!

Company details

Operator details for contracts and invoices.

Legal documents

Terms of use of the service and personal data processing.