Com a API REST da Papo, você pode listar, buscar, criar, atualizar e vincular contatos a Empresas do CRM — tudo por requisições autenticadas, sem abrir o painel. É a forma programática de manter a gestão de clientes B2B sincronizada com sistemas externos, ERPs, CRMs ou ferramentas de automação.
A API da Papo expõe recursos do módulo Empresas para que sua operação organize contas B2B, consolide contatos vinculados e acompanhe conversas recentes de cada empresa. Com autenticação por chave secreta e respostas em JSON, esses endpoints permitem integrar a visão de contas a scripts, automações e revendas white label.
Resumo das operações de Empresas via API
| Operação | O que faz | Quando usar |
|---|---|---|
| Listar empresas | Retorna as empresas cadastradas no CRM com nome, domínio e número de contatos. | Auditar a base de contas ou sincronizar empresas com outro sistema. |
| Buscar por nome ou domínio | Localiza empresas específicas no CRM. | Encontrar a conta B2B antes de atualizar dados ou vincular contatos. |
| Detalhar empresa | Retorna os dados de uma empresa pelo identificador. | Consultar uma conta específica durante uma integração. |
| Criar empresa | Cria uma nova empresa; o nome é obrigatório, enquanto domínio e descrição são opcionais. | Cadastrar contas B2B automaticamente a partir de um ERP, site ou fluxo externo. |
| Atualizar empresa | Atualiza nome, domínio e descrição de uma empresa existente. | Manter o CRM sempre alinhado com a base de clientes B2B. |
| Vincular contato | Vincula um contato existente do CRM a uma empresa. | Consolidar o relacionamento e o histórico entre contatos e contas. |
| Listar contatos e conversas | Traz os contatos vinculados à empresa e as conversas recentes desses contatos. | Ter a visão completa da conta durante o atendimento ou follow-up. |
Como funciona a autenticação da API
Todas as rotas de escrita, incluindo as operações de Empresas, exigem a chave secreta da conta. Ela deve ser enviada como token Bearer. A chave pública da conta é opcional, mas, se enviada, precisa corresponder à mesma conta da chave secreta.
A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta aparece uma única vez na criação; guarde-a em local seguro e revogue se houver suspeita de vazamento.
Como a API é REST e utiliza JSON, qualquer linguagem com suporte a HTTP pode ser usada para integrar Empresas a scripts, ERPs, CRMs ou ferramentas de automação. A documentação oficial em https://papo.global/pt/docs traz os detalhes de autenticação, parâmetros, respostas e exemplos de código.
Como gerenciar Empresas pela API na prática
- Acesse a área de desenvolvedor do painel da Papo e gere uma chave secreta. Copie também a chave pública da conta.
- Em cada requisição, autentique com a chave secreta como token Bearer. Se quiser reforçar a validação, envie a chave pública no cabeçalho indicado na documentação.
- Para listar as empresas do CRM, chame o endpoint de listagem de Empresas. A resposta traz nome, domínio e número de contatos de cada conta.
- Para localizar uma empresa específica, use o endpoint de busca por nome ou domínio. Assim você obtém o identificador necessário para atualizar dados ou vincular contatos.
- Para criar uma empresa, envie um payload JSON com o nome obrigatório. Domínio e descrição podem ser incluídos como dados opcionais.
- Para atualizar uma empresa, envie os novos valores de nome, domínio ou descrição no endpoint de atualização.
- Para vincular um contato existente, use o identificador do contato e o identificador da empresa na operação de vínculo.
Como a API processa uma operação por requisição, a gestão em massa é feita executando chamadas em sequência. Um script em Python, Node.js ou uma automação em ferramentas como n8n pode ler contas de um CSV ou ERP, cadastrar empresas, vincular contatos e coletar as respostas para tratamento de erros.
Para quem essa integração faz sentido
- Empresas B2B que mantêm contas em outro CRM ou ERP e querem sincronizar automaticamente com o módulo Empresas da Papo.
- Times comerciais que trabalham com clientes de conta, como agências, consultorias, SaaS e provedores, e precisam consolidar contatos e conversas por empresa.
- Operações que captam empresas em formulários, landing pages ou sistemas externos e desejam criá-las no CRM sem retrabalho manual.
- Revendas white label e integradores que conectam a Papo a sistemas de clientes e querem manter a gestão de contas consistente entre diferentes ambientes.
- Equipes de TI que constroem integrações customizadas usando a API como ponte entre a base de empresas e o restante da operação.
Perguntas frequentes
Preciso criar o contato antes de vincular a uma Empresa?
Sim. A API vincula um contato que já existe no CRM. Para cadastrar um contato novo, use os endpoints de criação de contatos e depois faça o vínculo com a empresa.
Quais dados posso atualizar em uma Empresa via API?
É possível atualizar nome, domínio e descrição da empresa. A criação exige o nome; domínio e descrição são opcionais.
A API permite listar as conversas de uma Empresa?
Sim. O módulo Empresas permite listar os contatos vinculados a uma empresa e as conversas recentes desses contatos, facilitando a visão de conta durante o atendimento.
A autenticação é a mesma usada nos outros endpoints da Papo?
Sim. As rotas de escrita exigem a chave secreta da conta, enviada como token Bearer. A chave pública é opcional e, se enviada, precisa corresponder à mesma conta.
Onde encontro os caminhos exatos e o formato do payload?
Na documentação oficial da API, disponível em https://papo.global/pt/docs. Lá estão os detalhes de autenticação, parâmetros, respostas e exemplos de código para Empresas e demais recursos.
Posso usar a API para sincronizar a base de Empresas com meu CRM atual?
Sim. Como a API é REST e utiliza JSON, você pode automatizar a listagem, criação, atualização e vínculo de contatos em sequência, mantendo os dois sistemas alinhados.
Leia também
- Como usar o módulo de Empresas no CRM da Papo
- Como usar a API da Papo para gerenciar atributos personalizados dos contatos
Comece grátis e gerencie Empresas no CRM via API →
O primeiro usuário da Papo é gratuito para sempre, sem cartão.