Contatos, cinco operações
Criar, consultar, listar, atualizar e arquivar. A listagem filtra por busca, plataforma, e-mail, ID externo e Updated Since, que é o filtro usado numa sincronização incremental.
Nó do n8n
Plano BusinessInstale o n8n-nodes-pinlyx pelo painel Community Nodes, cole uma chave de API e pronto: um formulário enviado vira contato, um negócio ganho vira fatura e uma conversa sem resposta vira mensagem no canal que a sua equipe acompanha. São oito operações em três recursos, sem dependências em tempo de execução e com licença MIT.
Plano grátis para sempre · Sem cartão de crédito · Cancele quando quiser
Última atualização:
Definição
Um nó da comunidade do n8n é um pacote publicado no npm que uma instância do n8n instala em tempo de execução, acrescentando um novo bloco ao canvas. Não é um fork do n8n, nem um receptor de webhooks que você precisa hospedar e manter no ar por conta própria.
n8n-nodes-pinlyx é o nó do Pinlyx. Ele se autentica com uma chave de API que você gera no painel e entrega ao fluxo oito operações sobre contatos, negócios e conversas, com a paginação por cursor já resolvida.
Publicado no npm como n8n-nodes-pinlyx, com o código no GitHub sob licença MIT. Testado no n8n 1.60 ou mais recente, com Node.js 20.15 ou superior. npm · GitHub
O nó conversa com a mesma API REST pública que um script usaria. Tudo o que ele faz pode ser reproduzido com curl, e o que ele não faz está a um nó HTTP Request de distância.
Três recursos, escolhidos porque são os que uma automação realmente usa. Todas as regras abaixo são aplicadas pela API, não pelo nó.
Criar, consultar, listar, atualizar e arquivar. A listagem filtra por busca, plataforma, e-mail, ID externo e Updated Since, que é o filtro usado numa sincronização incremental.
Crie um negócio com título, valor, moeda, etapa, probabilidade, data prevista de fechamento e observações. Liste com filtros por etapa, contato e busca no título.
As conversas com movimento recente em todos os canais conectados, das mais novas para as mais antigas. Cada linha traz o ID do contato, o canal, um indicador de não lida e uma prévia curta da última mensagem.
Grave o seu próprio identificador no contato e uma nova execução é recusada com HTTP 409, indicando o registro que já existe, em vez de criar em silêncio uma segunda cópia da mesma pessoa.
Ative Return All e o nó percorre todas as páginas para você. Deixe desativado e defina um limite. Cada página traz no máximo 100 linhas de contatos e negócios e 50 de conversas, então uma lista grande sempre exige várias requisições.
A credencial guarda uma única chave de API. Cada operação declara o escopo de que precisa, então uma chave sem contacts:write falha ao criar com um 403, em vez de parecer funcionar sem alterar nada.
O nó está publicado no npm como n8n-nodes-pinlyx e é instalado como qualquer nó da comunidade: de dentro do n8n, sem copiar arquivos para um servidor.
Ou, numa instância auto-hospedada, pela linha de comando:
npm install n8n-nodes-pinlyx
# then restart n8nUm detalhe que vale conhecer antes de planejar qualquer coisa: o n8n Cloud oferece apenas os nós da comunidade que o próprio n8n revisou e verificou, e este pacote ainda não passou por essa revisão. Instâncias auto-hospedadas instalam qualquer pacote publicado. No Cloud, as mesmas operações ficam disponíveis pelo nó HTTP Request apontado para a API REST. Preferimos dizer isso com todas as letras a deixar escondido.
O pacote não declara dependências em tempo de execução. Toda requisição passa pelo helper HTTP do próprio n8n, que é o que permite à credencial injetar o cabeçalho Authorization e o que mantém a instalação leve.
O nó se autentica com uma chave de API do Pinlyx: uma chave, um cabeçalho, sem ida e volta de OAuth.
O teste da credencial faz a chamada autenticada mais barata que existe:
curl https://api.pinlyx.com/v1/me \
-H "Authorization: Bearer csk_live_YOUR_KEY"As chaves de API fazem parte do plano Business. Nos planos Free e Pro não há chave para gerar, então a credencial não tem o que guardar. É o único pré-requisito que vale conferir antes de instalar qualquer coisa.
O limite padrão é de 60 requisições por minuto por chave. Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset, e quem passa do limite recebe HTTP 429 com um Retry-After em segundos. Como o limite é por chave e não por espaço de trabalho, um fluxo preso num loop freia a si mesmo em vez de sufocar as suas outras integrações.
Esta é a lista completa, não uma seleção dos melhores momentos.
Cada operação corresponde a exatamente um endpoint da API pública v1, então nada aqui se comporta diferente de uma requisição que você escreveria à mão.
O campo de plataforma de um contato aceita Telegram, WhatsApp, Instagram, LinkedIn, X e Email. Ele registra o canal pelo qual a pessoa chegou, que é como o CRM agrupa as conversas dela depois.
O que não está nessa lista não está no nó. Envio de mensagens, tags, pontuação de leads, tarefas, faturas e campanhas existem na API REST. Só não fazem parte destas oito operações.
É o motivo mais comum para usar este nó. Um lead preenche um formulário e o registro já está no CRM antes de alguém abrir uma aba.
Se você precisa de um upsert de verdade em vez de um 409, a API REST tem um endpoint em lote que busca correspondência por ID externo, e-mail, telefone ou username e aceita até 200 linhas por requisição. O nó não expõe esse endpoint. Aponte um nó HTTP Request para POST /v1/contacts/batch e você tem o mesmo resultado com uma chamada em vez de duzentas.
Vale ler antes de montar, porque o desenho óbvio é o errado.
Não dá para marcar um negócio como ganho pela API. Ganhar um negócio lança uma entrada de receita no livro-caixa do CRM, então essa mudança fica reservada de propósito ao painel, onde uma pessoa está olhando. O nó reflete isso: Deal, Create recusa as etapas won e lost, e não existe operação de atualização. Você lê negócios ganhos; não grava.
Se quinze minutos é lento demais, não encurte a consulta. Assine o evento: o Pinlyx dispara um webhook de saída em deal.won, assinado com HMAC-SHA256 no cabeçalho X-Webhook-Signature e com o nome do evento em X-Webhook-Event. Aponte-o para um nó Webhook do n8n e a fatura sai segundos depois de alguém fechar o negócio, sem gastar nada do limite com consultas. O mesmo vale para contact.created, contact.updated e message.received.
Conversation, Get Many devolve as conversas que tiveram movimento recente em todos os canais conectados: Telegram, WhatsApp, Instagram, X, e-mail e chat ao vivo do site numa só lista. Cada linha traz o ID do contato, o canal, se está não lida e até 160 caracteres da última mensagem.
Antes de montar isso, vale conhecer dois limites. A prévia é só uma prévia: o nó não percorre a conversa inteira, então o classificador sempre vê apenas a última mensagem. E o nó não consegue marcar um contato com tag nem enviar uma resposta. As duas coisas existem na API REST e no servidor MCP; nenhuma faz parte destas oito operações.
Três comportamentos que decidem se um fluxo sobrevive à primeira semana de uso real.
Uma resposta de listagem da API sobre a qual o nó funciona:
{
"items": [ { "Id": 812, "Name": "Sarah Lin", "Platform": "email" } ],
"nextCursor": 764,
"hasMore": true
}Sincronizações incrementais usam Updated Since. Guarde o horário da última execução bem-sucedida, passe esse valor na próxima e você puxa só o punhado de contatos que mudou, não todos. É a diferença entre uma sincronização noturna que termina e uma que gasta todo o limite com linhas que ninguém mexeu.
Limites sinceros
Seis coisas que é melhor ler aqui do que descobrir no meio da montagem de um fluxo.
A API REST consegue enfileirar uma mensagem no Telegram ou uma DM no X, e o servidor MCP também. Essas operações não estão neste nó. Se o fluxo precisa falar com um cliente, use um nó HTTP Request ou um dos nós de canal do próprio n8n.
Ganhar um negócio lança uma entrada de receita no livro-caixa, então essa mudança só acontece no painel. O nó cria negócios e os lista. Ele não os fecha, e Create recusa logo de cara as etapas won e lost.
Este é um nó de ação. Para iniciar um fluxo a partir de algo que acontece no CRM, cadastre um webhook de saída e receba-o com o nó Webhook do n8n. Consultar com um Schedule Trigger também funciona, mas consome um limite de requisições que o webhook não gasta.
Tags, pontuação de leads, atribuição de responsável, tarefas e movimentações no funil existem na API REST. Nenhuma delas está entre as oito operações. Contact, Update grava os campos simples e nada além disso.
Nada de faturas, lançamentos no livro-caixa, pagamentos ou reembolsos. Nada neste nó movimenta dinheiro em nenhuma direção, o mesmo limite que o servidor MCP respeita.
As chaves de API são um recurso do plano Business. Nos planos Free e Pro não há chave para colar na credencial, então o nó não tem com o que se autenticar, por mais correta que seja a instalação.
Três jeitos de conectar o mesmo CRM, cada um certo para um tipo de trabalho. A maioria das equipes acaba usando dois deles.
Trabalho previsível, por agendamento ou gatilho
Você sabe exatamente o que deve acontecer e quando. Chega um formulário, um contato é criado. Um negócio fecha, sai uma fatura. A lógica fica num canvas que toda a equipe consegue ler, e uma execução com falha aparece na lista de execuções junto com o payload que a causou.
Ideal quando a regra é fixa e o volume é constante.
Reagir no instante em que algo acontece
Cadastre um endpoint no CRM e ele envia dados para você em contact.created, contact.updated, message.received, deal.won e outros eventos. Assinados com HMAC-SHA256, reenviados com backoff e reprocessáveis a partir de um registro de entregas. Combine com um nó Webhook do n8n e você troca a consulta periódica pelo envio imediato.
Ideal quando a latência importa mais que a simplicidade.
Discernimento, não encanamento
Um assistente de IA decide na hora da chamada, com a conversa real diante dele, em vez de seguir uma regra escrita semanas antes. Ferramentas, recursos e prompts num único endpoint autenticado, com cada chamada limitada pelos escopos da chave.
Ideal quando a resposta depende de entender a situação.
As dúvidas que aparecem na primeira hora, respondidas com o comportamento real.
As outras portas de entrada para os mesmos dados e as partes do CRM em que um fluxo vai gravar.
A base por baixo do nó: chaves com escopos, paginação por cursor, gravações idempotentes, cabeçalhos de limite de requisições e webhooks de saída.
O mesmo CRM para um assistente de IA em vez de um fluxo: ferramentas, recursos e prompts num único endpoint autenticado.
Um passo a passo para desenvolvedores: gerar chaves, fazer a primeira requisição autenticada, verificar a assinatura do webhook e tratar o limite de requisições com backoff.
Quando um assistente deve decidir na hora da chamada, quando escrever código e quando um gatilho no-code é a resposta certa.
Gmail, Outlook, Calendly, Zoom, GitHub e os webhooks de saída que ligam o CRM a qualquer outra ferramenta.
O que um registro de contato realmente guarda: tags, campos personalizados, pontuação de leads, responsável e uma linha do tempo completa de atividades.
O funil em que as operações de negócios gravam, e por que marcar um negócio como ganho lança receita e continua no painel.
Comparação de planos, incluindo o plano Business, que traz chaves de API e webhooks, e o servidor MCP, disponível em todos os planos.
Hora de começar
Instale o nó, gere uma chave com dois escopos e deixe o primeiro formulário enviado chegar como contato. Daí em diante, é só arrastar mais um nó para o canvas.