BOT COM INTEGRAÇÃO API NO TELEGRAM

PROJETO: BOT DE MONITORAMENTO DE CORRIDAS VIA API

1. Apresentação do Projeto

Desenvolvimento de um bot integrado à API da plataforma de corridas, com a finalidade de monitorar automaticamente corridas que estejam em determinados status (como pendentes ou canceladas) e enviar as informações para um grupo privado da administração.

O bot funcionará como uma ferramenta de acompanhamento operacional, permitindo que a equipe administrativa tenha conhecimento rápido das solicitações disponíveis ou que necessitam de atenção.

⸻

2. Objetivo Principal

Criar uma automação capaz de:

* Consultar a API da plataforma de corridas;
* Identificar corridas pendentes ou canceladas;
* Capturar apenas as informações necessárias;
* Enviar automaticamente os dados para um grupo administrativo;
* Facilitar o acompanhamento das corridas pela equipe responsável.

⸻

3. Dados que deverão ser capturados da corrida

O bot deverá buscar através da API somente as seguintes informações:

* 👤 Nome do cliente;
* 📞 Número de telefone do cliente;
* 🚗 Categoria de corrida solicitada;
* 📍 Endereço de partida (caso disponível na API);
* 🆔 Identificação da corrida (opcional para controle interno);
* ⏰ Data e horário da solicitação.

⸻

4. Funcionamento do Sistema

Fluxo:

1. O bot realiza consultas automáticas na API da plataforma.
2. O sistema verifica novas corridas nos status configurados:

* Pendentes;
* Canceladas.

3. Ao encontrar uma nova corrida, o bot coleta os dados necessários.
4. O bot envia automaticamente a informação para o grupo privado da administração.
5. A equipe administrativa realiza o acompanhamento manual através das informações recebidas.

⸻

5. Exemplo de mensagem enviada no grupo administrativo

🚨 NOVA CORRIDA IDENTIFICADA

👤 Cliente:
**************

📞 Telefone:
(**********🚗 Categoria:
Executivo

📍 Local de partida:
Rua X, Bairro Y

⏰ Horário:
20:45

🆔 Código da corrida:
587421

⸻

6. Funcionalidades Necessárias

Monitoramento automático

O sistema deverá:

* Consultar a API em intervalos definidos;
* Identificar novas corridas;
* Evitar envio duplicado;
* Registrar quais corridas já foram notificadas.

⸻

Envio para grupo administrativo

O bot deverá:

* Enviar mensagens automaticamente;
* Manter um padrão organizado das informações;
* Funcionar continuamente;
* Permitir configuração do grupo responsável.

⸻

7. Limitações do Projeto

O bot NÃO deverá:

❌ Permitir que motoristas aceitem corridas através dele;

❌ Alterar status de corridas na plataforma;

❌ Enviar comandos de atualização para a API;

❌ Interferir no funcionamento original da plataforma.

A função será exclusivamente de consulta, monitoramento e envio de informações.

⸻

8. Segurança

O sistema deverá possuir:

* Acesso seguro à API;
* Controle das credenciais;
* Registro de atividades;
* Proteção contra duplicidade de notificações.

⸻

9. Informações necessárias para desenvolvimento

Será necessário disponibilizar:

* Documentação da API da plataforma;
* Forma de autenticação;
* Endpoint de consulta das corridas;
* Lista de status disponíveis;
* Estrutura dos dados retornados pela API.

⸻

Resultado Esperado

Um bot administrativo capaz de acompanhar automaticamente novas corridas através da API da plataforma, enviando informações essenciais para um grupo interno de gestão, permitindo uma tomada de decisão mais rápida sem interferir diretamente no sistema de corridas.