API do PipeRun: o que dá para fazer e como usar com agentes de IA
O PipeRun é um CRM brasileiro voltado a vendas B2B, com API REST para oportunidades, pessoas, empresas e atividades. É usado por times comerciais que querem automatizar a entrada de leads e o acompanhamento do funil. O acesso é por token de API da conta.
Os grandes recursos da API, em português claro.
Criação, atualização e movimentação de oportunidades nas etapas do funil.
Cadastro de contatos e organizações.
Tarefas, ligações e reuniões ligadas às oportunidades.
Consulta da estrutura de funis.
Registros e informações específicas do processo da empresa.
Como se acessa a API do Piperun.
- Com credencial da sua empresaUsa token de API gerado no PipeRun, de preferência ligado a um usuário de integração, enviado no cabeçalho das requisições.
- O token herda as permissões do usuário: use um usuário dedicado.
- Respeite os limites de requisições da API.
- Dados de contatos são pessoais e sujeitos à LGPD.
- api piperun
- piperun api documentação
- integração piperun
- piperun api oportunidades
- piperun webhook
- crm piperun api
O que um agente do iTeam faz com a API do Piperun.
O agente conversa com o lead, faz as perguntas do roteiro e cria a oportunidade no PipeRun já com resumo e etapa certa.
Oportunidades sem próxima atividade recebem lembrete ao vendedor com sugestão de abordagem.
Depois de cada call, o agente registra a nota e cria as tarefas combinadas na oportunidade.
O gestor recebe o valor em negociação por etapa e as oportunidades com maior risco de perder.
Da credencial ao agente trabalhando, com aprovação.
Gere o token no PipeRun
Crie o token de API com um usuário de integração que tenha acesso aos funis necessários.
Cadastre no cofre do iTeam
O token fica no cofre; você define quais funis cada agente movimenta e o que exige aprovação.
Teste em funil piloto
Valide a criação de oportunidades em um funil de teste e depois estenda para o funil principal.
Dúvidas sobre a API do Piperun.
A API do PipeRun é gratuita?
De forma geral, a API faz parte da assinatura do PipeRun; confirme com o fornecedor se o seu plano inclui acesso.
Preciso programar para usar a API do PipeRun com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam aprende os endpoints pela documentação e o time de implantação configura os fluxos.
O agente pode marcar oportunidade como perdida?
Pode, se você permitir; recomendamos que isso passe pela confirmação do vendedor.
Como o agente de IA se autentica na API do PipeRun?
Com um token de API gerado no PipeRun, de preferência de um usuário de integração, e enviado no cabeçalho das requisições. Não localizei a documentação pública para citar o nome exato do cabeçalho, então confirme com o suporte do PipeRun. Como o token herda as permissões do usuário, crie um perfil dedicado ao agente.
O agente consegue criar oportunidades no PipeRun a partir de um lead?
Consegue: a API trabalha com oportunidades, pessoas, empresas e atividades, então o lead do site ou do WhatsApp vira pessoa, empresa e oportunidade no funil certo, com a atividade de retorno marcada. O agente checa duplicatas antes de criar. As regras de qual funil e qual responsável recebem o lead vêm do time comercial.
O PipeRun tem sandbox para testar a integração?
Não encontrei um sandbox descrito, então confirme com o PipeRun. Na falta dele, use um funil de teste e um usuário de integração separado, onde o agente crie oportunidades marcadas como teste. Comece lendo funis, etapas e campos personalizados, e depois libere a criação. Apague os registros de teste ao final.
O agente pode marcar uma oportunidade como perdida no PipeRun?
Pode tecnicamente, mas é uma decisão comercial. O desenho recomendado: o agente sugere marcar como perdida quando o lead não responde por um período combinado, e o vendedor confirma, escolhendo o motivo. Assim se evita perder oportunidade viva por engano, e o motivo da perda fica padronizado para os relatórios.
Como ligar o PipeRun ao WhatsApp com agente de IA?
O agente atende o lead no WhatsApp, qualifica e grava no PipeRun o que descobriu: necessidade, orçamento e urgência, como campos ou notas. Quando o lead está pronto, a oportunidade vai ao vendedor com resumo. O contato volta ao agente se o vendedor demorar. No iTeam, a conversa fica no canal de WhatsApp da plataforma.
Quando um agente de IA com PipeRun não compensa?
Quando o funil não está definido, os campos são usados de formas diferentes por cada vendedor e ninguém confia nos dados. O agente reproduz essa desordem em escala. Também compensa pouco se há poucos leads por mês. Primeiro padronize etapas e campos obrigatórios; depois automatize o que se repete.
Webhooks do PipeRun ajudam o agente a reagir a mudanças?
Ajudam: a API lista webhooks, que avisam o agente quando uma oportunidade muda de etapa ou é criada, sem precisar consultar toda hora. Com isso ele cobra o vendedor de uma proposta parada ou agradece o cliente de um negócio ganho. Confira na documentação do PipeRun quais eventos estão disponíveis.
Os contatos do PipeRun podem ser usados pelo agente conforme a LGPD?
Podem, com finalidade definida e base legal, e o agente deve ver só o necessário de cada contato. Dados de pessoas e empresas no CRM são pessoais quando identificam alguém. Respeite pedidos de exclusão e de descadastro. Não é parecer jurídico: combine com o responsável por privacidade o que o agente pode fazer com a base.
