messages.createChat
Creates a new chat.
func (c *Client) MessagesCreateChat(ctx context.Context, request *MessagesCreateChatRequest) (*MessagesInvitedUsers, error)
Calling this method
client.Run(ctx, func(ctx context.Context) error {
api := client.API()
res, err := api.MessagesCreateChat(ctx, &tg.MessagesCreateChatRequest{
// see Parameters
})
if err != nil {
return err
}
_ = res // *MessagesInvitedUsers
return nil
})
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Users | []InputUserClass | yes | List of user IDs to be invited |
Title | string | yes | Chat name |
TTLPeriod | int | — | Time-to-live of all messages that will be sent in the chat: once message.date+message ttl_period === time(), the message will be deleted on the server, and must be deleted locally as well. You can use messages.setDefaultHistoryTTL to edit this value later. |
Returns
Possible errors
| Code | Type | Description |
|---|---|---|
| 500 | CHAT_ID_GENERATE_FAILED | Failure while generating the chat ID. |
| 400 | CHAT_INVALID | Invalid chat. |
| 400 | CHAT_MEMBER_ADD_FAILED | Could not add participants. |
| 400 | CHAT_TITLE_EMPTY | No chat title provided. |
| 400 | INPUT_USER_DEACTIVATED | The specified user was deleted. |
| 400 | TTL_PERIOD_INVALID | The specified TTL period is invalid. |
| 400 | USERS_TOO_FEW | Not enough users (to create a chat, for example). |
| 406 | USER_RESTRICTED | You're spamreported, you can't create channels or chats. |
References
- Official documentation
- Generated Go reference
- TL definition:
messages.createChat#92ceddd4