Connecting a bot built with a no-code builder

To connect bots built with no-code builders, we recommend using the auto-connect method.

What should you check when connecting?

Before using UTM tags, we recommend checking whether your bot supports additional parameters in start. (Some builders don't allow working with this parameter). To check this, build a link to your bot like this:

https://t.me/graspil_bot?start=test

Replace graspil_bot with your bot's username, paste this link into your browser, open it, and launch the bot. If your bot reacted as usual, i.e. sent back a start message, then you can use UTM tags.

If you've already launched the bot before, this launch might be treated by the bot as a repeat launch — some bots are configured so they don't react to a repeat launch, or react differently than you'd expect. Send the bot the /start command to see how it reacts to repeat launches without tags.

Builders that can be connected via API

puzzlebot.top

In Graspil, when connecting the bot, select the API method (if you didn't initially select this method, you can move on to the next steps in the instructions — the method will switch automatically once the system starts receiving data)

Go to your builder's dashboard and select the bot you need. Go to Settings -> Integrations -> Outgoing requests

Set the address: https://api.graspil.com/api/send-update

Check the box "Set header list" and add a header:

Key: Api-Key

Value: paste your graspil API key

Where do I get the API key?

You'll find the key in your dashboard, in the My Bots section. Select the relevant bot and click the key icon — a window with the key will appear.

Important!

After making all the changes, interact with the bot (for example, send the /start command) so that graspil receives the first data. After a few minutes, your bot's status will change to "connected"

salebot.pro

In Graspil, when connecting the bot, select the API method (if you didn't initially select this method, you can move on to the next steps in the instructions — the method will switch automatically once the system starts receiving data)

In salebot, select the project you need and go to the project settings. Find the Constants section and add the constant save_webhook=1

Go to basic settings and fill in the Webhook URL field:

Webhook URL: https://api.graspil.com/v1/send-update-salebot?api-key=replace_with_your_graspil_API_key

Where do I get the API key?

You'll find the key in your dashboard, in the My Bots section. Select the relevant bot and click the key icon — a window with the key will appear.

Important!

After making all the changes, interact with the bot (for example, send the /start command) so that graspil receives the first data. After a few minutes, your bot's status will change to "connected"

Sending additional events/conversions

If you want to send additional events to graspil, for example "sale", check out the API section sending a target event. Builders often let you send a webhook when a specific event occurs (for example, on a sale).