Para gerar as chaves de API da Papo (https://papo.global/), acesse o painel e vá em Configurações > Desenvolvedores (ou API). Lá você encontra sua chave pública fixa e pode criar chaves secretas nomeadas, que são exibidas apenas uma vez e devem ser armazenadas em local seguro, como um gerenciador de senhas ou variáveis de ambiente no servidor.
A API da Papo utiliza um par de chaves para identificar e autenticar sua conta em integrações com CRMs, ERPs, plataformas de automação (n8n, Zapier) e sistemas próprios. Entender a diferença entre elas e saber como gerá‑las e protegê‑las é o primeiro passo para construir automações confiáveis.
| Tipo de Chave | Formato | Função | Nível de Exposição |
|---|---|---|---|
| Chave Pública | pk_live_... |
Identifica sua conta Papo de forma única. | Pode ser exposta no frontend ou em scripts públicos. |
| Chave Secreta | sk_live_... |
Autentica requisições e autoriza ações na sua conta. | Confidencial – jamais deve ser compartilhada ou versionada em código. |
Como gerar as chaves de API
- Faça login no painel da Papo e acesse Configurações.
- No menu lateral, localize a seção Desenvolvedores ou API.
- A página exibirá sua Chave Pública (
pk_live_...). Ela é fixa e pode ser copiada a qualquer momento. - Para obter uma Chave Secreta, clique no botão para criar uma nova chave.
- Dê um nome descritivo (ex.: “Integração CRM”, “Automação n8n”) para facilitar a gestão futura.
- A chave secreta (
sk_live_...) será exibida uma única vez. Copie‑a imediatamente e guarde‑a em um local seguro.
⚠️ Por segurança, a Papo armazena apenas o hash da chave secreta. Se você perder o valor original, não será possível recuperá‑lo. Nesse caso, revogue a chave comprometida e gere uma nova.
Como armazenar as chaves de forma segura
- Nunca coloque a chave secreta diretamente no código‑fonte, em repositórios Git ou em mensagens.
- Utilize variáveis de ambiente no seu servidor (ex.:
PAPO_SECRET_KEY) e referencie‑as no código. - Armazene a chave em um gerenciador de senhas (como 1Password, Bitwarden ou o cofre do seu provedor de nuvem) para consulta futura.
- Se a chave vazar ou houver suspeita de comprometimento, acesse a mesma página de desenvolvedores, localize a chave na lista e revogue‑a imediatamente. Depois, crie uma nova e atualize suas integrações.
Para que servem essas chaves?
As chaves são usadas em todas as chamadas à API da Papo que exigem autenticação. A chave secreta é enviada no cabeçalho Authorization como um token Bearer. A chave pública pode ser enviada no cabeçalho X-Papo-Public-Key como verificação adicional, mas a autenticação principal depende sempre da secreta.
Com as chaves em mãos, você pode, por exemplo:
- Enviar mensagens de WhatsApp via API.
- Consultar contatos extraídos pelo Extrator.
- Acionar a inteligência artificial da Papo a partir do seu sistema.
- Sincronizar dados com seu CRM ou ERP.
Perguntas Frequentes
Onde encontro a chave pública da minha conta?
A chave pública (pk_live_...) fica visível na página Configurações > Desenvolvedores (ou API). Ela é fixa e pode ser copiada sempre que necessário.
Posso ter mais de uma chave secreta?
Sim. Você pode gerar várias chaves secretas, cada uma com um nome diferente (ex.: “Produção”, “Teste”, “n8n”). Isso ajuda a isolar acessos e revogar uma chave específica sem afetar as demais.
Perdi minha chave secreta. O que fazer?
A chave secreta não pode ser recuperada. Acesse a página de desenvolvedores, revogue a chave perdida e crie uma nova. Atualize suas integrações com o novo valor.
Preciso da chave pública para autenticar?
Não obrigatoriamente. A autenticação é feita pela chave secreta. A chave pública é opcional e serve como identificador adicional, mas não substitui a secreta.
Como revogar uma chave secreta?
Na lista de chaves da página de desenvolvedores, localize a chave que deseja desativar e clique na opção de revogar. A partir desse momento, qualquer requisição que utilize essa chave será recusada.
Posso usar as chaves em ferramentas como n8n ou Zapier?
Sim. As chaves de API da Papo são compatíveis com qualquer ferramenta que suporte autenticação via Bearer token. Basta inserir a chave secreta no campo de autorização da ferramenta.
Leia também
Crie sua conta gratuita na Papo e tenha acesso imediato às chaves de API para integrar seus sistemas.