Runbook operacional · Altis / Ana Lisboa

Ponte de Leads: ManyChat, n8n e Clint

Como montar, do zero, o caminho que leva um comentário do Instagram até um card no funil certo da Clint — com telefone normalizado, link de WhatsApp pronto e tag da campanha.

Escrito em 11/09/2026 Tempo ~25 min por campanha nova Pré-requisito nenhum código

ManyChat

Conversa no Direct, coleta NOME, TEL e email em campos personalizados e dispara uma Solicitação externa com o Full Contact Data.

n8n

Recebe, normaliza o telefone para E.164 de qualquer país, monta o link do WhatsApp Web e os links do Manychat, e repassa.

Clint

Cria ou atualiza o contato, abre o negócio na etapa Base da origem, aplica a tag e avisa quem tem que atender.

Versão curta

Se você já fez isso antes, é só esta sequência.

  1. Criar a origem na Clint e as etapas
  2. Nova integração, tipo Receber Webhook
  3. Mapear os 6 campos e pôr a tag na Etapa 5
  4. Copiar o link da integração
  5. Duplicar um workflow do n8n
  6. Trocar a URL da Clint no nó HTTP
  7. Trocar o Path do nó Webhook
  8. Ativar e copiar a Production URL
  9. Colar essa URL na Solicitação externa do ManyChat
  10. Salvar, Atualização, e testar
01

Clint: criar a origem e a integração

Comece sempre pela Clint. É ela que gera o endereço que o n8n vai chamar, então sem isso o resto não tem para onde apontar.

  1. Criar a origem (o funil)

    Em Negócios, no seletor de funil no topo, use + Adicionar. Dá para criar um Novo grupo na mesma tela — o grupo é só a gaveta onde o funil mora.

    Se você não escolher o grupo, a Clint joga o funil no grupo padrão dela. Já aconteceu de um funil de terapia nascer dentro de "Retiros" por causa disso.

  2. Definir as etapas

    Engrenagem no topo direito do funil → Etapas e atividades. A primeira etapa precisa se chamar de um jeito que você reconheça depois, porque é nela que o lead vai nascer. O padrão da casa é Base na entrada e Fechado no fim.

    Use a engrenagem, não o menu ⋮ ao lado dela. O ⋮ falha em abrir com frequência; a engrenagem abre o modal direto.

  3. Criar os campos que ainda não existem

    Se a campanha precisa de um campo que a Clint não tem — por exemplo Link do WhatsApp Web — crie antes, senão ele não aparece para mapear. Abra qualquer contato → aba Contato → Gerenciar campos.

    Os campos que a ponte usa hoje: Nome, Email, Telefone, Instagram, Link do WhatsApp Web e Link da conversa Manychat.

  4. Abrir uma nova integração

    Engrenagem da origem → aba Integrações → + Nova Integração. Uma origem pode ter várias integrações convivendo (a Aula 12.09.26 tem uma do Yay Forms e uma do ManyChat).

    Escolha certa Pegue a integração genérica Receber Webhook, não o conector nativo do ManyChat. A nativa pede a chave de API da conta e só deixa mapear os campos que o ManyChat conhece. A genérica não pede chave nenhuma e deixa você digitar qualquer nome de campo — é o que torna tudo isso simples.

  5. Etapa 3 — o que criar, e como

    Três escolhas nesta tela:

    • Negócio (não Contato) — você quer um card no funil, não só uma ficha.
    • Criar ou atualizar — se a pessoa já existe na base, atualiza em vez de duplicar.
    • Nome da integração — use um nome que diga a origem, tipo ManyChat - Aula 12.09.26.
    "Criar ou atualizar" tem preço. A Clint casa por telefone ou e-mail e sobrescreve o que estava lá. Numa base de 57 mil contatos com números malformados, colisão acontece. Foi decisão sua conviver com isso, porque o dado de quem acabou de digitar costuma ser o mais novo.

  6. Guardar o link da integração

    Nessa mesma tela aparece o Link de integração. É esse endereço que o n8n vai chamar. Copie e guarde — você vai colar ele no n8n daqui a pouco. O formato é sempre:

    https://functions-api.clint.digital/endpoints/integration/webhook/<id-da-integração>

  7. Etapa 4 — mapear os campos

    Esta é a tela que decide o que entra no card. Para cada linha: digite o nome no campo Identificador do campo, clique em Adicionar novo campo, e no seletor que aparece do lado escolha o campo da Clint.

    Os seis mapeamentos da ponte, exatamente assim:

    O que o n8n mandaCampo na Clint
    nameNome
    emailEmail
    phoneTelefone
    whatsapp_webLink do WhatsApp Web
    live_chat_urlLink da conversa Manychat
    ig_usernameInstagram
    Como usar o seletor sem perder tudo Digite o nome do campo, aperte ↓ para descer até a opção, confira que ela é a certa e só então Enter. Clicar na opção com o mouse fecha o modal inteiro e joga fora o que você fez. E nunca aperte Esc em modal da Clint — descarta tudo sem avisar.

  8. Etapa 5 — tag, etapa e status

    É aqui que quase todo mundo esquece alguma coisa. Quatro campos:

    • Adicionar tag para contatos — a tag da campanha, tipo AULA SÁBADO. Sem isso o lead chega pelado.
    • Etapa para criação — Base.
    • Etapa para atualização — Manter etapa do negócio, para lead que volta não regredir no funil.
    • Status — Aberto.
    Cuidado ao escolher a tag A primeira opção da lista é "Criar <o que você digitou>" e ela já vem destacada. Enter direto ali cria uma tag nova e errada na base inteira. Desça com ↓ até a tag que já existe antes de confirmar.

    Salve. A Clint mostra "Integração salva com sucesso" e repete o link — é o mesmo do passo 6.

  9. Ligar as notificações

    Engrenagem da origem → Notificações. Marque quem tem que ser avisado de negócio novo.

    Limitação da Clint: só aceita pessoa, não setor. Cada social seller nova precisa ser acrescentada aqui na mão. Não tem como automatizar.

    Não mexa em Permissão de usuários. Campo vazio ali significa "todo mundo vê". Colocar nomes cria uma restrição — o contrário do que parece.

02

n8n: duplicar o fluxo e reapontar

Você nunca monta um workflow do zero. Duplica um que já funciona e troca dois endereços. O cérebro — o nó que normaliza telefone de 180 países — vem junto e você não precisa encostar nele.

  1. Abrir a pasta dos fluxos

    No n8n, projeto Personal → pasta MANYCHAT - FLOWS. Ali moram os três fluxos da ponte. Use qualquer um como molde; o mais completo é o da Altis Lisboa.

  2. Duplicar

    No ⋮ à direita do workflow → Duplicate. Dê o nome já no padrão: ManyChat (<conta>) → Clint | <origem>. A cópia nasce desativada, que é o que você quer enquanto edita.

    Se ela cair fora da pasta, volte no ⋮ → Move → escolha MANYCHAT - FLOWS.

  3. Trocar o endereço da Clint

    Abra a cópia. Clique no terceiro nó, o HTTP Request (o que tem nome de "Clint | ..."). Troque o campo URL pelo link de integração que você copiou na Parte 1.

    Não mexa em mais nada desse nó. O corpo já está certo:

    Method   POST
Body     JSON
JSON     {{ JSON.stringify($json) }}

    Renomeie o nó para o nome da origem nova, só para você se achar depois.

  4. Trocar o Path do Webhook

    Clique no primeiro nó, o Webhook. O campo Path veio igual ao do original — dois fluxos não podem dividir o mesmo endereço, então troque por algo único.

    Pode ser qualquer texto sem espaço. O padrão da casa é um identificador aleatório, mas aula-05-10-2026 funciona igual e é mais fácil de reconhecer.

    Confirme que o HTTP Method está em POST. O nó nasce em GET, e o ManyChat manda POST.

  5. Conferir o nó do meio (quase sempre, nada a fazer)

    O nó Normalizar contato é um Code node. Ele descobre a conta do ManyChat sozinha pelo próprio payload e procura os campos ignorando maiúsculas, então serve para qualquer conta. Só mexa nele em dois casos:

    • O ManyChat novo chama os campos de outra coisa (não NOME, TEL, EMAIL) — aí acrescente o nome novo dentro do pick([...]) correspondente.
    • Você usou o conector nativo do ManyChat na Clint em vez do Receber Webhook — aí a saída tem que se chamar WHATSAPP-ID em vez de whatsapp_web. Se seguiu este runbook, não é o seu caso.

  6. Ativar e pegar a URL de produção

    Chave Active no topo direito. Depois clique de novo no nó Webhook e copie a Production URL — é o endereço que o ManyChat vai chamar:

    https://n8n-altis-n8n-start.jd2z5l.easypanel.host/webhook/<seu-path>
    Tem duas URLs no painel do nó: Test e Production. A de teste só responde enquanto você está com o editor aberto e clicou em "Listen". A que vai para o ManyChat é sempre a de produção.
03

ManyChat: ligar o cano

Do lado do ManyChat é um passo só, no fim da conversa, depois que a pessoa já entregou nome, telefone e e-mail.

  1. Achar a automação certa

    Antes de editar qualquer coisa, confirme na lista de automações que ela está LIVE e com contatos maior que zero. Cópias paradas com nome parecido são comuns, e editar a errada custa uma rodada inteira.

    Na dúvida de qual automação rodou: abra app.manychat.com/<conta>/chat/<id do contato> e leia o histórico. Está escrito lá com todas as letras: "iniciado na automação: <nome>".

  2. Criar o passo de Ação

    Depois da última mensagem, ligue um passo do tipo Ação. Dentro dele, duas ações:

    • Definir campo do usuário → ID DO CONTATO = {ID do contato}. Opcional, mas é o que monta os links do Manychat se o payload vier capado.
    • Solicitação externa → a parte que importa.

  3. Configurar a Solicitação externa

    Abra a Solicitação externa e preencha:

    • Tipo de Pedido: POST
    • Solicitar URL: a Production URL do n8n
    • Aba Corpo: clique em + Adicionar Full Contact Data — o corpo fica {Full Contact Data} e mais nada
    O campo come a primeira letra Colar ou digitar a URL nesse campo às vezes perde o primeiro caractere — vira ttps://. Sempre releia a URL inteira antes de salvar.

    Não mexa em Cabeçalho, Resposta nem Mapeamento de respostas. Salvar.

  4. Publicar

    Salvar a requisição não basta. No topo direito da automação, o botão Atualização fica azul quando tem mudança pendente. Clique nele. Quando voltar a ser um Salvo cinza e apagado, publicou.

    Fluxo sem gatilho mostra STOPPED e isso não é problema se ele for disparado por sequência ou envio em massa — é o caso da SOS. STOPPED só quer dizer "não tem gatilho próprio".
04

Testar sem sujar a base

  1. Escolher um telefone e um e-mail que não existam

    Antes de disparar, vá em Contatos na Clint e busque o telefone e o e-mail que você vai usar no teste. Tem que dar 0 contatos nos dois.

    Por que isso não é paranoia Um teste com o número inventado 912345678 bateu num contato real de janeiro e, como o modo é "Criar ou atualizar", trocou o nome da pessoa pelo nome do teste e criou um negócio falso para ela. Deu trabalho para desfazer.

  2. Rodar o teste de verdade

    Comente no post do Instagram e faça o caminho inteiro, como uma lead faria. Teste de mesa não pega erro de gatilho nem de campo personalizado.

  3. Conferir no n8n antes de conferir na Clint

    No workflow, aba Executions. Abra a última e olhe os três nós:

    • Webhook — chegou o body com custom_fields preenchidos?
    • Normalizar contato — o phone saiu com + e o DDI certo?
    • Clint | ... — respondeu {"success": true}?
    Se não aparecer execução nenhuma, o problema é do lado do ManyChat: URL errada, automação errada, ou mudança não publicada. Se aparecer execução no workflow antigo, você editou a automação errada.

  4. Conferir o card

    O card tem que nascer na etapa Base, com a tag da campanha, e ao abrir o contato os seis campos preenchidos. Depois apague o card de teste: abra o card → ⋮ no topo → Excluir.

    Excluir o negócio não apaga o contato. O contato de teste fica na base — sem problema, mas fica.

05

Armadilhas que já custaram tempo

Todas essas aconteceram de verdade na montagem dos três fluxos. Vale ler antes, não depois.

  • Editar a automação parada em vez da que roda

    Contas grandes têm cópias com nome quase igual. Uma delas está LIVE e as outras são rascunho.

    Fix Olhe a coluna de status e a de contatos na lista de automações antes de abrir.

  • DDD 55 confundido com DDI 55

    55999912345 tem 11 dígitos: é um celular do DDD 55, Santa Maria/RS. Um normalizador ingênuo lê o prefixo e devolve um número quebrado.

    Fix Já resolvido no Code node — a regra é comprimento nacional vence aparência de prefixo. Só não substitua esse nó por uma expressão.

  • Telefone sem o "+"

    A Clint separa o DDI sozinha quando recebe em E.164. Sem o +, o número entra capenga, sem código de país.

    Fix Nada a fazer se você usar o Code node existente. Ele já entrega com +.

  • Lead do Instagram vem sem país

    O Instagram não informa o país, então o normalizador assume Brasil. Uma pessoa de fora que digite o número local dela sai com +55 na frente.

    Fix Aceito. Só resolveria perguntando o país na conversa, e não vale o atrito.

  • Expressão no lugar do Code node

    O parser de {{ }} do n8n não engole JavaScript completo. Ele falha com "invalid syntax", o webhook responde 200 do mesmo jeito e a execução morre em silêncio — nada chega na Clint e nada acusa erro.

    Fix Lógica complicada sempre em nó Code, nunca em expressão.

  • O construtor do ManyChat fica girando pra sempre

    O canvas do fluxo não desenha nada enquanto a janela do Chrome está atrás de outra. Parece travamento do ManyChat.

    Fix Traga a janela do Chrome para a frente e espere uns 10 segundos.

  • Popup da Clint aparece no canto da tela

    Menus de contexto e dropdowns da Clint renderizam no canto superior esquerdo quando a aba não está em primeiro plano. Você clica no lugar visualmente certo e não acontece nada.

    Fix Deixe a aba em primeiro plano antes de abrir menu.

06

Referência do que está no ar

Estado em 11/09/2026. Os endereços de webhook aparecem truncados de propósito — eles funcionam como chave, e quem tem o link inteiro consegue injetar lead direto no funil. Os primeiros caracteres bastam para você identificar qual é qual; o valor completo você copia na tela da integração na Clint e no nó Webhook do n8n.

Fluxo n8nIDConta ManyChatOrigem na Clint
ManyChat (Ana Lisboa) → Clint | Altis TherapyTEOlNY4zuLDdisU2fb484153Altis Therapy
ManyChat (Altis Lisboa) → Clint | Altis TherapyTXhMg7jbfr1X8dvcfb2393683Altis Therapy
ManyChat (Ana Lisboa) → Clint | Aula 12.09.26FU42PuNRKQN22j5Kfb484153Aula 12.09.26
EndereçoValor
Pasta dos fluxos no n8nprojects/WVkVnLaqSvmTXBIz/folders/exM1DcwBgpJS6zh3
Webhook n8n — Altis Therapy (Ana)/webhook/7a2b3265-…
Webhook n8n — Altis Therapy (Altis)/webhook/dcd9f70e-…
Webhook n8n — Aula 12.09.26/webhook/77aa1064-…
Integração Clint — Altis Therapy.../webhook/68ef64bb-…
Integração Clint — Aula 12.09.26.../webhook/1677b2a2-…
Campo personalizado no ManyChatfb484153fb2393683
NOME1492901014952839
email / EMAIL1243018814952838
TEL1492901614952836
ID DO CONTATO1495085614952834
WHATSAPP-ID1459995414952833
Nunca clique nisso Em Configurações → Extensões → API do ManyChat, os botões "Recuperar A Chave API" e "Excluir Chave API". "Recuperar" ali significa regenerar, e isso quebra de uma vez os workflows do n8n que falam com a API do ManyChat.