Start a conversation with a bot using a deep linking parameter
API section: Working with deep links
messages.startBot#e6df7378 bot:InputUser peer:InputPeer random_id:long start_param:string = Updates;
| Name | Type | Description |
|---|---|---|
| bot | InputUser | Bot. |
| peer | InputPeer | The user or chat the request is about. |
| random_id | long | A random number from the client. The server uses it to discard duplicates when a request goes out twice. |
| start_param | string | Parameter from a ?start=… link. |
This method has no errors of its own: it either answers or fails on the shared checks below.
| Code | Type | What it means |
|---|---|---|
| 401 | AUTH_KEY_UNREGISTERED |
The server does not know this session: the key was revoked, expired, or the call was made before authorisation. |
| 401 | API_ID_INVALID |
This api_id was never issued or has been blocked. Keys come from my.ansible.su. |
| 400 | CONNECTION_LAYER_INVALID |
The client did not declare a layer, or declared one the server does not know. |
| 420 | FLOOD_WAIT_X |
Too often. Do not retry for X seconds — the number arrives in the error text. |
| 500 | INTERNAL |
A failure on our side. The request may be retried; if it keeps failing, it is a bug of ours. |