Logotipo DRDiM Nexus DRDiM Nexus

Guia do Bot Telegram

Configurações do Telegram

O que é o Bot Telegram?

O Bot Telegram é uma ferramenta que permite gerenciar seu negócio diretamente pelo aplicativo Telegram. Com ele, você pode realizar vendas, cadastrar produtos, consultar informações e emitir documentos fiscais de qualquer lugar, mesmo sem acesso ao computador.

Primeiros Passos

1. Configure o Bot

Acesse as configurações do Telegram no menu e siga as instruções para criar e configurar seu bot.

Ir para Configurações
2. Conecte o Webhook

Use o botão "Configurar Webhook" para conectar seu bot ao sistema DrDim.

É necessário ter um domínio HTTPS válido ou usar ngrok para testes.
3. Inicie o Bot

Abra o Telegram, pesquise pelo nome do seu bot e envie o comando /start.

O bot responderá com as opções disponíveis.

Comandos Disponíveis

/start

Inicia a conversa com o bot e mostra as opções iniciais.

Use este comando para começar a interagir com o bot ou para reiniciar a conversa a qualquer momento.

/help

Exibe a ajuda com todos os comandos disponíveis.

Útil quando você precisa de um lembrete sobre os comandos que pode usar.

/menu

Mostra o menu principal com todas as opções.

Você pode usar este comando a qualquer momento para voltar ao menu principal.

/produtos

Acessa o menu de gerenciamento de produtos.

Permite listar, cadastrar, buscar e gerenciar produtos.

/vendas

Acessa o menu de vendas e emissão de documentos.

Permite iniciar uma venda, adicionar produtos, selecionar cliente e finalizar com NFC-e.

/clientes

Acessa as opções de gerenciamento de clientes.

Permite buscar clientes existentes ou cadastrar novos.

/config

Acessa as configurações fiscais e do sistema.

Permite configurar parâmetros fiscais e outras opções do sistema.

Exemplos de Fluxos de Trabalho

Cadastrar um Novo Produto
  1. Envie /produtos
  2. Selecione "Cadastrar Produto"
  3. Informe o nome do produto
  4. Informe o valor de venda
  5. Selecione a categoria
  6. Confirme o cadastro
O produto será adicionado ao seu catálogo e estará disponível para vendas.
Realizar uma Venda
  1. Envie /vendas
  2. Selecione "Nova Venda"
  3. Busque o cliente pelo nome ou CPF/CNPJ
  4. Adicione produtos à venda
  5. Selecione a forma de pagamento
  6. Finalize a venda
  7. Opcional: Emita NFC-e
A venda será registrada no sistema e o estoque será atualizado automaticamente.
Consultar um Cliente
  1. Envie /clientes
  2. Selecione "Buscar Cliente"
  3. Digite o nome ou CPF/CNPJ do cliente
  4. Visualize os dados cadastrais
  5. Opcional: Veja o histórico de compras
Você terá acesso aos dados do cliente e poderá iniciar uma venda diretamente.
Emitir NFC-e
  1. Envie /vendas
  2. Selecione "Emitir NFC-e"
  3. Busque a venda pelo código ou data
  4. Confirme os dados fiscais
  5. Aguarde o processamento
  6. Receba o link para o DANFE
A NFC-e será emitida e o DANFE poderá ser compartilhado diretamente pelo Telegram.

Perguntas Frequentes

Para ambiente de desenvolvimento, você pode usar o ngrok para criar um túnel HTTPS:

  1. Baixe e instale o ngrok
  2. Execute o comando: ngrok http 80 (ou a porta do seu servidor)
  3. Copie a URL HTTPS fornecida (exemplo: https://a1b2c3d4.ngrok.io)
  4. Cole essa URL no campo "URL Base HTTPS" na configuração do Telegram
  5. Clique em "Configurar Webhook"

Se o bot não estiver respondendo, verifique:

  1. Se o token está configurado corretamente
  2. Se o webhook está configurado e funcionando (use o botão "Verificar Status")
  3. Se seu servidor é acessível pela internet (requerido pelo Telegram)
  4. Se o protocolo HTTPS está funcionando corretamente
  5. Verifique os logs do sistema em storage/logs/laravel.log

Caso persista o problema, tente remover o webhook e configurar novamente.

O bot do Telegram é público por padrão, o que significa que qualquer pessoa que encontrar seu bot pode interagir com ele. Para restringir o acesso:

  1. Acesse a página de configurações do Telegram
  2. Ative a opção "Restringir Acesso"
  3. Adicione os IDs ou usernames dos usuários autorizados

Para obter o ID de um usuário, você pode pedir para ele enviar o comando /id para o bot @userinfobot no Telegram.

Sim, você pode personalizar as mensagens e respostas do bot através das configurações:

  1. Acesse a página de configurações do Telegram
  2. Vá para a aba "Mensagens"
  3. Edite as mensagens padrão conforme sua preferência
  4. Salve as alterações

Você pode usar marcadores como {nome_cliente} e {valor_total} que serão substituídos pelos valores reais.

Baixar Documentação Completa (PDF)
Customização do Sistema
Temas
Cor do cabeçalho

Opções alinhadas à identidade DRDiM.