Ansible APIs

Ansible offers several interfaces for developers. The Bot API lets you build programs that interact with users through messages. The Ansible API and adlib are intended for building your own messenger clients.

You can also add Ansible widgets and Ansible sign-in to your website.

Designers can explore stickers and emoji and custom themes.


Bot API

Bot Manager

Bots use HTTPS to work with messages, files, buttons and mini apps. Bot Manager helps create and manage bots.

You do not need to implement the MVSy protocol to use the Bot API. Requests use HTTPS, and the Ansible server handles interactions with the messenger. Available methods and parameters are described in the reference.

Bot platform · Bot API reference · Bot features


Ansible API / MVSy

Use the MVSy protocol and TL schema to build a client. Compatible method and type names remain part of the protocol even where product names differ.

MVSy · TL schema · API methods · API layers · api_id / api_hash


adlib — build your own Ansible client

adlib is the Ansible client library based on TDLib. Find the library, Bot API and client source repositories on the applications page.

The library handles networking, the protocol and local data so you can focus on your application’s interface and behavior. Check support for the features you need against the selected library and server versions.


Widgets and sign-in

Web widgets · Login / OAuth · Share · Posts · Comments


Diamonds and gifts

Diamonds are the internal currency of Ansible. Wallets and gifts operate within our system; TON, Toncoin, cryptocurrency withdrawals and purchases through Fragment are not supported. Compatible APIs retain technical names such as Stars and XTR.

Real payment providers are not enabled yet. A payment method in the reference does not imply that bank-card checkout is available.


Gateway API

Gateway API status. Public pricing and onboarding terms have not been published.


Compatibility and status

The reference describes interfaces; it does not guarantee every scenario on every client. See the technical overview for project status and limitations. Check the method, layer and client version before integrating.

Back to top