TamTam

About TamTam

TamTam Bot API lets developers build bots that interact with the TamTam messaging platform over HTTPS requests to the botapi.tamtam.chat domain. Bots can communicate with users, respond to requests, present programmed buttons (callback, link, request_contact, request_geo_location, and chat types), and request personal data such as name, phone number, or a short reference. Typical use cases include support and FAQ bots, sending informational messages, running votes or like/dislike polls, linking to external resources, and forwarding users into a chat or channel.

The API uses standard HTTP verbs (GET, POST, PUT, DELETE, PATCH) with JSON-formatted, UTF-8 encoded request and response bodies, and returns standard HTTP status codes along with a JSON error object containing a code and message on failure. Bots receive event notifications either through webhook push subscriptions or through long polling, but not both simultaneously; webhook delivery retries for up to 8 hours and is rate-limited to 100 notifications per second by default, with webhook traffic originating from a defined set of TamTam IP subnets.

The API also supports deep linking, allowing a start link to pass a payload of up to 128 characters to a bot when a user opens a chat with it, and a "constructor mode" where a bot can generate ready-to-send messages or keyboards in response to a user's in-app message composition request. Bot creation and editing is handled through PrimeBot, the platform's built-in bot for managing other bots.

Key features

• REST HTTP API for building bots on TamTam via botapi.tamtam.chat
• Send, edit, and delete messages including buttons and media attachments
• Receive events via WebHook push notifications or long polling
• Programmable inline buttons: callback, link, request_contact, request_geo_location, and chat
• Deep linking support to pass startup payload data to bots
• Constructor mode lets bots build messages interactively on a user's behalf

Frequently asked questions