2017-03-11 19:54:51 +01:00
---
title: sendBotStartMessage
description: Invites bot to a chat (if it is not in the chat) and send /start to it. Bot can't be invited to a private chat other than chat with the bot. Bots can't be invited to broadcast channel chats and secret chats. Returns sent message. UpdateChatTopMessage will not be sent, so returned message should be used to update chat top message
---
## Method: sendBotStartMessage
[Back to methods index ](index.md )
2017-06-06 18:39:21 +02:00
YOU CANNOT USE THIS METHOD IN MADELINEPROTO
2017-03-11 19:54:51 +01:00
Invites bot to a chat (if it is not in the chat) and send /start to it. Bot can't be invited to a private chat other than chat with the bot. Bots can't be invited to broadcast channel chats and secret chats. Returns sent message. UpdateChatTopMessage will not be sent, so returned message should be used to update chat top message
### Params:
| Name | Type | Required | Description |
2017-08-20 11:05:56 +02:00
|----------|---------------|----------|-------------|
2017-03-11 19:54:51 +01:00
|bot\_user\_id|[int](../types/int.md) | Yes|Identifier of the bot|
2017-04-11 10:09:20 +02:00
|chat\_id|[InputPeer](../types/InputPeer.md) | Yes|Identifier of the chat|
2017-03-11 19:54:51 +01:00
|parameter|[string](../types/string.md) | Yes|Hidden parameter sent to bot for deep linking (https: api.telegram.org/bots#deep-linking)|
### Return type: [Message](../types/Message.md)
### Example:
```
$MadelineProto = new \danog\MadelineProto\API();
2017-04-10 13:49:32 +02:00
if (isset($token)) { // Login as a bot
2017-06-19 18:56:47 +02:00
$MadelineProto->bot_login($token);
2017-03-11 19:54:51 +01:00
}
2017-04-10 13:49:32 +02:00
if (isset($number)) { // Login as a user
2017-03-11 19:54:51 +01:00
$sentCode = $MadelineProto->phone_login($number);
echo 'Enter the code you received: ';
$code = '';
for ($x = 0; $x < $sentCode['type']['length']; $x++) {
$code .= fgetc(STDIN);
}
$MadelineProto->complete_phone_login($code);
}
2017-07-23 16:33:46 +02:00
$Message = $MadelineProto->sendBotStartMessage(['bot_user_id' => int, 'chat_id' => InputPeer, 'parameter' => 'string', ]);
2017-03-11 19:54:51 +01:00
```
2017-07-24 01:32:29 +02:00
Or, if you're using the [PWRTelegram HTTP API ](https://pwrtelegram.xyz ):
2017-07-23 16:11:02 +02:00
### As a bot:
POST/GET to `https://api.pwrtelegram.xyz/botTOKEN/madeline`
Parameters:
* method - sendBotStartMessage
2017-07-23 16:40:54 +02:00
* params - `{"bot_user_id": int, "chat_id": InputPeer, "parameter": "string", }`
2017-07-23 16:11:02 +02:00
2017-07-23 16:34:36 +02:00
2017-07-23 16:11:02 +02:00
### As a user:
POST/GET to `https://api.pwrtelegram.xyz/userTOKEN/sendBotStartMessage`
Parameters:
bot_user_id - Json encoded int
chat_id - Json encoded InputPeer
parameter - Json encoded string
2017-07-23 16:40:54 +02:00
2017-07-23 16:11:02 +02:00
2017-03-11 19:54:51 +01:00
Or, if you're into Lua:
```
2017-07-23 16:33:46 +02:00
Message = sendBotStartMessage({bot_user_id=int, chat_id=InputPeer, parameter='string', })
2017-03-11 19:54:51 +01:00
```