Connecting the bot on the constructor
For bots built with constructors, we recommend using the auto connection method.
What should you check when connecting?
Before using UTM tags, we recommend checking whether your bot supports additional parameters in start. (Some constructors do not allow working with this parameter.) To do this, create a link like this for your bot:
https://t.me/graspil_bot?start=testReplace graspil_bot with your bot’s username, open this link in your browser, follow it, and launch the bot. If your bot reacts as usual (for example, sends the default start message), it means you can use UTM tags.
If you have already launched the bot before, this launch may be considered a repeated start. Some bots are configured not to react to repeated launches or react differently than you might expect. Send the /start command in the bot to see how it responds to repeated starts without parameters.
Platforms that can be connected via API
puzzlebot.top
In Graspil, when connecting a bot, select the API method (if you didn’t initially choose this method, you can proceed with the following steps in the instructions, and the method will automatically change once the system starts receiving data).
Go to your platform’s dashboard and select the desired bot. Navigate to Settings -> Integrations -> Outgoing Requests
Set the URL: https://api.graspil.com/api/send-update
Check the option “Set header list” and add the following header:
Key: Api-Key
Value: insert your Graspil API key
Where to find the API key?
You can find the key in your Graspil dashboard, under My Bots. Select the relevant bot and click on the key icon; a window with the key will appear.
Attention!
After making all the changes, interact with the bot (e.g., send the /start command) so that Graspil receives the first data. Within a few minutes, the status of your bot will change to “connected.”
salebot.pro
In Graspil, when connecting a bot, select the API method (if you didn’t initially choose this method, you can proceed with the following steps in the instructions, and the method will automatically change once the system starts receiving data).
In SaleBot, select the desired project and go to the project settings. Find the Constants section and add the constant: save_webhook=1.
Go to the General Settings section 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 to find the API key?
You can find the key in your Graspil dashboard, under My Bots. Select the relevant bot and click on the key icon; a window with the key will appear.
Attention!
After making all the changes, interact with the bot (e.g., send the /start command) so that Graspil receives the first data. Within a few minutes, the status of your bot will change to “connected.”
Transmitting additional events/conversions
If you want to send additional events to Graspil, such as “sale”, pay attention to the API section on sending target events. Often, platforms allow the setup of webhook sending upon specific events (e.g., a sale).
Last updated