Análise ponta a ponta Telegram → amoCRM: como conectar canal, bot e CRM

Uma demanda comum de empresas que vendem pelo Telegram: o tráfego chega a um canal, depois vai para um bot montado em uma ferramenta no-code, e os negócios são fechados no amoCRM. O caminho do cliente se estende por três sistemas, e sem análise ponta a ponta fica difícil saber qual fonte de tráfego realmente gera vendas — ou em qual etapa do funil os assinantes desistem.

Vamos ver como o Graspil resolve isso — usando como exemplo um caso típico: canal → bot em uma ferramenta de terceiros → amoCRM, em que é preciso saber quem entrou no canal e quando, por qual link a pessoa chegou ao bot e em qual etapa o negócio está agora no CRM.

Como funciona

O esquema é montado em três partes conectadas:

1. Marcação do canal. O tráfego que entra no canal é marcado com tags UTM — por links de convite do Telegram (para tráfego interno do Telegram) ou por links tlin.cc do Graspil (para tráfego externo, de anúncios ou do site).
2. Vínculo entre canal e bot por usuário. O Graspil identifica o usuário pelo seu user_id do Telegram. Quando a mesma pessoa que entrou no canal por um link marcado depois inicia o bot, o Graspil a reconhece e continua o funil sem perder a origem. O parâmetro start não é obrigatório para isso: é uma forma adicional de passar tags diretamente para o bot, por exemplo para tráfego externo via links tlin.cc, ou para marcar de qual publicação a pessoa veio.
3. Passagem das tags para o amoCRM. Ao iniciar o bot, o Graspil localiza o negócio/contato correspondente no amoCRM e grava as tags nos campos dele — geralmente usando os campos nativos de UTM do amoCRM.

Como resultado, os relatórios do Graspil mostram todo o funil de uma vez: entrada no canal → início do bot → etapas do negócio no CRM, sem exportações manuais.

Importante: a análise ponta a ponta (canal + bot) não é obrigatória. Se você não tem canal, ou não precisa rastreá-lo, pode conectar apenas o bot e enviar ao amoCRM as tags no nível do bot (a origem de entrada no próprio bot) — isso também funciona plenamente e não exige um canal.

Conectando um bot que já funciona em uma ferramenta no-code

Uma dúvida comum: “nosso bot já está conectado a uma ferramenta de terceiros, dá para adicioná-lo ao Graspil sem quebrar o que já funciona?”

Sim. O método recomendado é a conexão automática por token (protocolo MtProto). Ela funciona em paralelo com a conexão atual do bot à ferramenta e não interfere nela: a ferramenta continua processando mensagens normalmente, enquanto o Graspil recebe os dados separadamente, via MtProto.

Se você pretende usar tags UTM dentro do próprio bot (não só no nível do canal), vale a pena verificar antes se o bot aceita passar parâmetros pelo start — algumas ferramentas limitam isso. Há um guia separado na documentação sobre como verificar.

Como as tags chegam ao amoCRM

A integração com o amoCRM no Graspil é somente de escrita: o Graspil atualiza campos de um negócio, mas não lê dados do amoCRM diretamente. A lógica é configurada pelo construtor de automações: qual ação executar (criar um negócio, atualizar um existente, ou apenas enviar as tags para um já vinculado), e em quais campos do amoCRM gravar quais dados — definido por um mapeamento.

Uma particularidade do próprio amoCRM que vale conhecer: assim que o Graspil (ou qualquer outra coisa) edita um negócio e grava algo em seus campos, ele automaticamente sai da categoria “Não classificado”. Essa é uma limitação do próprio amoCRM, não do Graspil, mas afeta o processo: se for importante para você que os negócios passem primeiro manualmente por “Não classificado”, vale considerar isso na configuração.

O caminho de volta: eventos do amoCRM para o Graspil

Essa é a parte mais específica de cada configuração. Se você quer ver na análise não só “chegou ao bot”, mas também “chegou ao pagamento” ou “passou para determinada etapa do negócio”, os eventos precisam ser enviados do amoCRM de volta para o Graspil. Duas opções:

Por palavras-chave — se a conversa com o cliente acontece em texto dentro do próprio bot, é possível configurar um gatilho que registra um evento-alvo ao detectar uma frase como “Obrigado pelo pedido”.

Por webhook na mudança de etapa do negócio — se os vendedores trabalham no amoCRM e não escrevem no bot, a única opção é enviar um webhook do amoCRM para o Graspil quando o status do negócio muda.

A questão-chave aqui é o pareamento: por qual campo o webhook recebido vai se vincular a um usuário específico no Graspil. Essa parte é configurada individualmente, de acordo com o seu funil e a estrutura de campos no seu amoCRM.

Como conectar

1. Conecte o canal e o bot. Os dois guias estão na documentação — conexão do bot, conexão de canais.
2. Conecte a integração. Na seção “Integrações”, autorize e conecte o amoCRM ou o Kommo.
3. Se precisar da passagem ponta a ponta de tags UTM — nas configurações do recurso (o canal), vincule-o ao bot. Depois disso, as tags com as quais o usuário chegou ao canal também ficam disponíveis no bot.
4. Crie uma automação para exportar os dados. Gatilho — início do bot (ou qualquer outro evento necessário), ação — a integração com amoCRM/Kommo, onde você especifica quais dados vão para quais campos.
5. Se precisar de dados de volta do amoCRM — configure um webhook para a API do Graspil, ou rastreie palavras-chave nas mensagens do bot (veja acima).
6. Monte o relatório. A opção mais óbvia é um funil ponta a ponta com divisão por UTM: primeira etapa — entrada no canal, segunda — início do bot, depois eventos de venda e outras etapas conforme a necessidade.

Se algo disso parecer complicado, ou você quiser uma configuração fora do padrão — fale com o suporte, vamos ajudar a configurar tudo.

Resumo

Conectar canal do Telegram → bot → amoCRM é feito com as ferramentas padrão do Graspil, sem precisar refazer o esquema atual do bot. A análise ponta a ponta (com canal) dá uma visão mais completa, mas não é obrigatória — dá para se limitar às tags no nível do bot. A passagem de dados para o amoCRM é configurada por automações, e os eventos vindos do CRM chegam por webhooks, configurados individualmente de acordo com a estrutura de campos e o funil do cliente.