# Api class

## Why do you need an Api class?

If you want to send a message to another user, call **api method** for a **different bot**, or get data from the [api reference](https://core.telegram.org/bots/api), you can use **Api class methods**

## Get Api class in controller

To get **Api class** in controller, use `@GetApi` property decorator, and **Api class** as type

{% code title="app.controller.ts" %}

```typescript
import { OnCommand, Controller, GetApi, Api } from 'nestgram';
import { AppService } from './app.service';

@Controller()
export class AppController {
  @GetApi() api: Api;

  constructor(private readonly appService?: AppService) {}

  @OnCommand('start')
  async start(): Promise<string> {
    await this.api.send('userId', 'Hello!'); // send message
    return 'Hello, world!';
  }
}
```

{% endcode %}

#### .send Api method take arguments:

<table><thead><tr><th data-type="number">Argument</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>1</td><td>User ID or channel ID (<em>string or number</em>)</td><td><strong>Required</strong></td></tr><tr><td>2</td><td>Message you want to send (you can use <strong>MessageSend class</strong> too)</td><td><strong>Required</strong></td></tr><tr><td>3</td><td>Keyboard</td><td>Optional</td></tr><tr><td>4</td><td><a href="https://core.telegram.org/bots/api#sendmessage">Options</a></td><td>Optional</td></tr></tbody></table>

{% hint style="info" %}
If you want to get a bot token, you can get it via `.token` **api property**
{% endhint %}

## Api methods

You can use any method from the **Answer class** in the **Api class**

{% hint style="info" %}
If Api method takes chat id or message id, you need to pass it as 1st and 2nd arguments
{% endhint %}

## Get Api for different token

If you want to call some **api method** for **different bot**, use `bot.to` method

{% hint style="info" %}
bot.to method takes argument: token you want to get api
{% endhint %}

{% code title="main.ts" %}

```typescript
import { ChatAction } from 'nestgram';
import { bot } from './bot';

bot.to('token').send('chatId', new ChatAction('typing'));
```

{% endcode %}