> For the complete documentation index, see [llms.txt](https://vkfast.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vkfast.gitbook.io/docs/api/utils.md).

# Методы-утилиты

### `sendMessage`

Удобное использование метода `messages.send` для отправки сообщений. Можно указывать дополнительные параметры вызова, помимо изначально заданных.

```php
sendMessage(
    int|string|array $peer_ids, // id чата/пользователя (можно указать массив)
    string|int $message, // текст сообщения
    ?Keyboard $keyboard = null, // объект клавиатуры
    ?Forward $forward = null, // объект пересланного сообщения
    bool $mentions = false, // вкл/выкл упоминания. По умолчанию упоминания выключены
    ?string $attachment = null, // вложения формата {type}{owner_id}_{media_id}
    ...$arguments // другие параметры вызова метода messages.send
)

$api->sendMessage(2000000001, 'Привет!', payload: ...) // дополнительно указываем параметр payload
$api->sendMessage(2000000001, 'Привет!', arguments: ['payload' => ...]) // дополнительно указываем параметр payload
```

### `convertUserId`

Для того, чтобы конвертировать строку вида:

```
https://vk.com/id1
https://vk.com/screenname
screenname
[id1|screenname] (так выглядит упоминание через @)
```

в обычный ID пользователя, можно использовать метод класса `VkApi`.

Например, пользователь упомянул какого-то участника или кинул ссылку на него, эту ссылку можно пропустить через метод ниже и получить чистый `ID` упомянутого пользователя. В случае неудачи определения ID будет возвращен `false`.

```php
convertUserId(string|int $value): int|bool

$api->convertUserId('https://vk.com/pavel'); // 325654
$api->convertUserId('https://vk.com/id325654'); // 325654
$api->convertUserId('[id325654|упоминание]'); // 325654
$api->convertUserId('pavel'); // 325654
```

### `isChatMember`

Метод для проверки, является ли пользователь участником определенного чата.

```php
isChatMember(
    int $user_id,
    int $peer_id
): bool

$api->isChatMember(325654, 2000000001)
```

{% hint style="info" %}
Обертка над методом messages.getConversationMembers
{% endhint %}

### `isAdminChat`

Метод для проверки наличия у пользователь админки в чате.

```php
isAdminChat(
    int $user_id,
    int $peer_id
): bool

$api->isAdminChat(325654, 2000000001)
```

{% hint style="info" %}
Обертка над методом messages.getConversationMembers
{% endhint %}

### `getGroupRole`

Метод для получения роли пользователя в определнной группе.

```php
getGroupRole(
    int $user_id,
    int $group_id
): bool|string

$api->getGroupRole(325654, 1234213134)
```

{% hint style="info" %}
Обертка над методом groups.getMembers
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vkfast.gitbook.io/docs/api/utils.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.