# Funções da API do Telegram

As funções da API expandem significativamente as capacidades de um bot no Telegram. Ao usar funções da API, você pode trabalhar com anexos, grupos e chats no Telegram — por exemplo, automatizando o bloqueio ou desbloqueio de usuários, e muito mais!

{% hint style="info" %}
Origem: [API do bot do Telegram](https://core.telegram.org/bots/api)
{% endhint %}

{% hint style="warning" %}
Importante! 

Para entender como trabalhar com funções da API, recomendamos fortemente revisar as regras para especificar funções e parâmetros na calculadora.

<mark style="color:vermelho;">**NOTAÇÃO:**</mark>

<mark style="color:vermelho;">**!**</mark> — um ponto de exclamação indica parâmetros obrigatórios

**parameter=None** — isso mostra o valor padrão para o parâmetro especificado.

É <mark style="color:vermelho;">**incorreto**</mark> simplesmente copiar o texto da função da documentação, assim: tg\_send\_message(platform\_id, "Some text", client\_message\_id=61818138, reply\_markup=None, parse\_mode=None, disable\_web\_page\_preview=0, protect\_content=False)

Os valores após os sinais de igual representam os valores padrão de cada parâmetro. Portanto, se você não precisar de um parâmetro específico, mas precisar de um que venha depois dele, não pode simplesmente ignorar o que não será usado — em vez disso, você deve passar explicitamente o valor padrão dele.

Assim, o <mark style="color:verde;">**uso**</mark> correto seria: tg\_send\_message(platform\_id, "Some text", 61818138, None, None, 0, True)
{% endhint %}

### Onde posso conseguir o <mark style="color:vermelho;">platform\_id</mark> para enviar notificações?

* Você precisa ter um bot do Telegram conectado ao seu projeto.
* Envie qualquer mensagem para este bot a partir da conta do Telegram na qual você deseja receber notificações.
* Na lista de clientes do projeto, selecione o diálogo do cliente para o qual você deseja enviar solicitações.
* Copie o valor do ID do campo do messenger.

<div data-with-frame="true"><figure><img src="/files/c55d0f3341353b777dd4c0445cfdecc886b617c7" alt="" width="359"><figcaption></figcaption></figure></div>

<details>

<summary>Exemplo de passagem do <mark style="color:vermelho;">platform_id</mark> parâmetro:</summary>

1. O parâmetro platform\_id pode ser passado sem especificar explicitamente valores numéricos.

<figure><img src="/files/c33d203cea04361239203acec6e62068bd0c34a5" alt=""><figcaption><p>platform_id foi fornecido sem nenhum valor</p></figcaption></figure>

`react = tg_set_reaction(platform_id, 1556, '👌')`

Funções com este parâmetro funcionarão mesmo sem especificar explicitamente um valor para platform\_id.
\
Importante: Na maioria das funções, este parâmetro é obrigatório e não deve ser omitido. <br>

2\. Se você precisar usar a função em um chat, canal ou grupo específico, você deve fornecer o platform\_id como um valor numérico.

<figure><img src="/files/b65c075f1a2d5c9ef67212ff9b0bbdbb0e90a5b3" alt="" width="563"><figcaption></figcaption></figure>

Na função **tg\_send\_message(!platform\_id, !text)** mostrada acima, o platfor&#x6D;**\_id parameter** é passado usando aspas envolvendo um valor numérico:

`tgmess = tg_send_message('1234566788', 'Olá!')`&#x20;

<figure><img src="/files/760210e13f3a96377975a6eca63fed078659e356" alt="" width="563"><figcaption></figcaption></figure>

</details>

### Como definir botões no parâmetro reply\_markup

**Exemplo de botões de resposta:**

`opts = {"keyboard": [[{"text": "Esquerda"}, {"text": "Direita"}]]}`

**Exemplo de botões inline:**

opts = {"inline\_keyboard": \[\[{"text": "Pacote 1","callback\_data":1}, {"text": "Pacote 2","callback\_data":2}]]}

### Como usar formatação de texto (Markdown) no parâmetro parse\_mod&#x65;**?**&#x20;

O **parse\_mode** parâmetro formata o texto inteiro ou partes dele em *itálico* ou **negrito**. Ele pode ter os valores: html, markdown ou markdownV2.

1. <mark style="color:azul;">**Se você escolher html:**</mark>

&#x20;        valores **texto em negrito**, use  `"<b>caption</b>"`

&#x20;        valores *texto itálico*, use `"<i>caption</i>"`

2. <mark style="color:azul;">**Para Markdown:**</mark>

&#x20;        valores **texto em negrito**, use  `"*caption*"`

&#x20;        valores *texto itálico*, use  `"_caption_"`

**Exemplo de envio de texto em itálico:**\
`tg_send_message(47615196, "<i>itálico</i>",None,None,"html")`

**Exemplo de envio de texto em negrito:**\
`tg_send_message(platform_id, '*test*', None, None, 'markdown')`


---

# Agent Instructions: 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://docs.mavibot.ai/doc/pt/chatbot/mensageiros/telegram/api.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.