Pular para o conteúdo principal
Voltar aos recursos

CRM para Telegram

API do CRM do Telegram - Automatize Seu Fluxo de Trabalho no Telegram

API do CRM de Telegram: uma API REST com escopo de workspace para sincronizar chats e contatos, disparar broadcasts, criar tickets e construir ferramentas.

Teste grátis

Visão geral

Visão geral: API do CRM do Telegram

A API REST do Entergram dá acesso programático a todo o seu workspace de CRM do Telegram. Sincronize chats e contatos para BigQuery, Postgres, HubSpot ou Salesforce. Dispare broadcasts no Telegram quando um pagamento do Stripe falhar ou um negócio for fechado. Crie tickets a partir de alertas de monitoramento.

Construa o dashboard interno que sua equipe realmente quer. Cada chamada de API tem escopo de workspace, é registrada em auditoria e governada pelo mesmo modelo de escopo de menor privilégio usado em toda a plataforma. As chaves são rotacionáveis, restringíveis por IP e revogáveis com um clique.

Para integrações com agentes de IA, veja a página complementar do servidor MCP do Telegram - ela expõe a mesma superfície de dados através do Model Context Protocol, para que Claude, ChatGPT e outros agentes de IA possam interagir diretamente com seu workspace do Telegram.

Todo o seu CRM do Telegram, à disposição do seu código

Tudo o que você faz no painel do Entergram, seu código também faz.

É uma API REST simples - chaves com escopo de workspace, JSON, verbos HTTP padrão - então qualquer linguagem capaz de fazer uma requisição consegue listar e pesquisar chats do Telegram, ler o histórico de mensagens, gerenciar contatos e campos personalizados, abrir e atualizar tickets e disparar broadcasts.

Configure suas permissões uma única vez: os mesmos escopos valem para a API, para o servidor MCP e para a integração com o Make. com.

Leia a documentação da API

  1. Sincronize o Telegram para seu data warehouse

    Extraia chats, contatos e valores de campos personalizados do Entergram em um agendamento. Coloque-os no BigQuery, Postgres, HubSpot ou Salesforce, para que o resto do negócio possa cruzar os dados do Telegram com todos os outros canais. Basta um cron job noturno e algumas chamadas de API.

  2. Dispare broadcasts do Telegram a partir de eventos externos

    Quando um pagamento falha no Stripe, quando um negócio é fechado no seu CRM, quando um alerta de monitoramento dispara - faça um POST para o Entergram e um broadcast do Telegram é enviado ao segmento marcado certo com o template certo. Mensageria orientada a eventos sem sair da sua stack atual.

  3. Criação programática de tickets

    Formulários, ferramentas de monitoramento, pipelines de e-mail de suporte - sempre que um evento estruturado acontece - envie-o por POST como um ticket vinculado ao chat certo do Telegram com a prioridade e o SLA certos. Fecha o ciclo entre o Telegram e todos os outros canais que sua equipe usa.

  4. Ferramentas e dashboards internos

    Construa o dashboard de liderança que sua equipe realmente quer - pipeline por estágio, tempo de resposta por representante, throughput de tickets - apoiado pela API do Entergram. Ter escopo de workspace significa que ele só consegue ver os seus dados. Combine com Retool, Appsmith ou um frontend React personalizado.

Especificações

API do CRM do Telegram em detalhe

Especificações

Saiba mais
  • Marque chats automaticamente a partir de gatilhos externosCliente atinge um marco no seu produto → uma chamada de API adiciona a tag VIP e avança a coluna Estágio. Na próxima vez que você abrir o chat do Telegram, o contexto do CRM já estará lá. Funciona com qualquer webhook ou sistema de eventos.
  • Segurança e ciclo de vida das chaves de APIAs chaves têm escopo de workspace, são hasheadas de forma irreversível em repouso e exibidas apenas uma vez na criação. Configure TTL (padrão 90 dias, menor se preferir), listas de IPs permitidos opcionais (faixas CIDR) e revogue qualquer chave imediatamente na aba Desenvolvedores. Cada chamada é registrada em auditoria com prefixo da chave, IP e user agent.
  • Modelo de escoposworkspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Os mesmos escopos se aplicam à API, ao servidor MCP e à integração com o Make.com. Escolha o mínimo que sua integração precisa - o menor privilégio limita o impacto caso uma chave vaze.
  • Integração com o Make.com (low-code)Não quer escrever código? A integração com o Make.com usa o mesmo modelo de escopos. Conecte o Entergram a centenas de apps com cenários visuais. As ações do app atualizam tags, atualizam dados de contato e marcam um chat como lido, por exemplo pagamento no Stripe → atualização de tag no CRM ou envio de formulário no Typeform → dados de contato.
  • Complemento: servidor MCP do TelegramSe você quer que agentes de IA (Claude, ChatGPT, Cursor) interajam com seu workspace do Telegram, confira o servidor MCP do Telegram - ele expõe a mesma superfície da API através do Model Context Protocol, para que agentes de IA possam descobrir e chamar ferramentas automaticamente, sem que você escreva nenhum código de cliente de API.
RecursoDetalhe
Requisito de planoPro (e assentos Pro em workspace)
ProtocoloREST (JSON sobre HTTPS)
Endpointschats · messages · contacts · custom_fields · tickets · broadcasts · workspace · members · accounts
AutenticaçãoChave de API com escopo de workspace (token Bearer)
TTL padrão da chave90 dias (configurável para menos)
Lista de IPs permitidosFaixas CIDR opcionais
RevogaçãoImediata
AuditoriaCada chamada registra prefixo da chave, IP, user agent
Limites de taxaPor chave, por endpoint - 429 com cabeçalho Retry-After

Perguntas frequentes

O que posso fazer com a API do CRM do Telegram?

Listar e pesquisar chats do Telegram, ler o histórico de mensagens, gerenciar contatos e campos personalizados, criar e atualizar tickets com prioridade e responsável, disparar broadcasts para segmentos marcados, adicionar e remover tags, e atualizar valores de campos personalizados. Cada endpoint tem escopo de workspace e é registrado em auditoria.

Quais escopos estão disponíveis?

workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Escolha o mínimo que sua integração precisa - o menor privilégio limita o impacto caso uma chave vaze. Os mesmos escopos se aplicam à API, ao servidor MCP e à integração com o Make.com.

Exemplos concretos - o que equipes reais constroem?

Uma equipe de trading sincroniza cada chat do Telegram no BigQuery de hora em hora para que analistas possam cruzar com dados on-chain. Uma equipe de suporte de SaaS tem um cron job que puxa os tickets não resolvidos de ontem e os envia para um resumo no Slack. Uma equipe de growth dispara um broadcast no Telegram a partir de um webhook sempre que um evento de upgrade do Stripe chega. Uma equipe de ops construiu um dashboard no Retool mostrando tempo de resposta por representante, throughput de tickets e distribuição de estágios do pipeline - tudo movido pela API do Entergram.

Como crio e gerencio chaves de API?

Vá até a aba Desenvolvedores no seu workspace do Entergram. Clique em 'Criar chave', selecione os escopos de que precisa, opcionalmente defina um TTL menor e uma lista de IPs permitidos, e copie a chave. A chave bruta é exibida apenas uma vez - guarde-a com segurança. As chaves são hasheadas de forma irreversível em repouso. Revogue qualquer chave imediatamente na mesma aba.

Como roto uma chave vazada?

Aba Desenvolvedores → encontre a chave pelo prefixo → Revogar (imediato). Depois crie uma nova chave com os mesmos escopos e lista de IPs permitidos, implante-a na sua integração e verifique a informação de último uso da chave antiga para confirmar que não há mais tráfego.

A API pode ver os dados de outro workspace?

Não. Cada chamada de API tem escopo do workspace que emitiu a chave. Uma chave do workspace A literalmente não consegue ler o workspace B - o escopo é aplicado no servidor em cada consulta.

Quais erros HTTP posso ver?

401 = a chave está expirada, revogada ou é a errada para o workspace. 403 = a chave não tem o escopo necessário, ou a requisição veio de um IP fora da lista permitida. 429 = você atingiu um limite de taxa; reduza o ritmo e tente novamente respeitando o cabeçalho Retry-After.

Qual é a diferença entre a API e o servidor MCP?

Ambos acessam os mesmos dados do workspace com os mesmos escopos. A API é para o seu código - cron jobs, webhooks, ferramentas internas, pipelines de sincronização. O servidor MCP é para agentes de IA - Claude, ChatGPT, Cursor - que descobrem e chamam ferramentas automaticamente através do Model Context Protocol. Use a API quando o consumidor é código; use o servidor MCP quando é IA.

A API suporta webhooks?

Webhooks de saída estão no roadmap. Hoje, o padrão é baseado em pull: chame a API em um agendamento ou em resposta aos seus próprios eventos. O app do Make.com também tem gatilhos para eventos do workspace; confira a lista dentro do Make antes de montar um cenário em torno de um deles.

Recursos relacionados do CRM para Telegram

Ver todos os recursos do CRM para Telegram
CRM de vendas para Telegram Um só pipeline para cada vendedor e cada conta: etapas, responsáveis e campos personalizados em chats reais do Telegram. Ferramenta de Broadcast do Telegram: Broadcasts Personalizados de Contas Reais Envie uma mensagem do Telegram para muitos chats das suas contas reais, personalizada por pessoa, no ritmo do Telegram e distribuída entre contas. Gerencie Várias Contas do Telegram em Uma Caixa de Entrada Gerencie várias contas do Telegram em uma caixa de entrada, sem trocar de conta. Tudo espelha o Telegram, então sua equipe alterna entre Telegram e Entergram. Proxy Grátis para Telegram: Um IP Dedicado para Cada Conta Conectada Proxy gratuito do Telegram com cada conta ligada: um IP privado e dedicado por conta, sem rotação e sem grupos partilhados.

Guias práticos

Entenda o fluxo de trabalho antes de escolher

Cenários do Make.com para CRM no Telegram usando a EntergramMake.com + Entergram: 12 automações de Telegram que você consegue montar em menos de uma horaA Entergram já vem com integração ao Make.com no plano Pro. Aqui estão 12 cenários concretos do Make, de transmissões disparadas pelo Stripe à sincronização de contatos com o Airtable, que transformam uma caixa de entrada do Telegram em um alvo real de automação, com cenários reais e contagem de etapas.9 min de leitura
Automação do Telegram para empresas: das respostas rápidas aos agentes de IA12 min de leituraTodos os guias
Teste grátis