**A API da Papo (https://papo.global/) é uma interface de programação que permite que desenvolvedores conectem outros sistemas, como CRMs, ERPs ou plataformas de automação (como n8n), diretamente à sua conta Papo. Ela serve para automatizar ações, como enviar mensagens de WhatsApp, consultar contatos do Extrator ou acionar a inteligência artificial da plataforma, sem precisar usar a interface gráfica.** A API abre um leque de possibilidades para personalizar e escalar sua operação, integrando as funcionalidades da Papo aos fluxos de trabalho já existentes na sua empresa. Em vez de realizar ações manualmente no painel, seu próprio software pode comandar a Papo para executar tarefas. ## API, Webhooks e Integrações Prontas: Qual a diferença? É comum confundir esses três conceitos. A tabela abaixo resume a principal diferença entre eles e quando usar cada um. | Característica | API (Interface de Programação) | Webhooks | Integrações Prontas | | :--- | :--- | :--- | :--- | | **Direção** | Seu sistema **pede ou envia** dados para a Papo. | A Papo **envia** dados para seu sistema. | A Papo se conecta a outro serviço. | | **Iniciativa da Ação** | Seu sistema externo. | A plataforma Papo. | O usuário, ao configurar no painel. | | **Conhecimento Técnico** | Requer programação ou uso de ferramentas como n8n. | Requer um endpoint (URL) no seu sistema para receber os dados. | Não requer programação, apenas configuração no painel. | | **Exemplo de Uso** | Enviar uma mensagem de WhatsApp quando uma compra é aprovada no seu e-commerce. | Notificar seu sistema de faturamento sempre que um novo contato é criado na Papo. | Conectar sua conta do Google Agenda para que a IA da Papo possa marcar reuniões. | ## Para que serve a API da Papo? Com a API, você pode construir automações e integrações sob medida para o seu negócio. Algumas das principais aplicações incluem: * **Enviar Mensagens:** Inicie conversas ou envie notificações de WhatsApp a partir do seu próprio sistema (ex: confirmação de pedido, lembrete de pagamento). * **Acessar Contatos do Extrator:** Consulte a lista de leads gerados pelo Extrator da Papo e importe-os para seu CRM ou ferramenta de marketing. * **Gerenciar Instâncias:** Verifique o status das suas conexões de WhatsApp diretamente do seu backend. * **Utilizar a Inteligência Artificial:** Envie um texto para a API de IA e receba uma resposta gerada com base no prompt configurado na sua conta Papo, permitindo usar a mesma inteligência em outros contextos. * **Sincronizar Dados:** Mantenha seus contatos, empresas e negócios sincronizados entre a Papo e seu CRM principal. * **Criar Dashboards Personalizados:** Extraia dados de atendimento e performance para alimentar painéis de Business Intelligence (BI) com métricas específicas da sua operação. ## Como começar a usar a API Para utilizar a API, é necessário ter conhecimento técnico ou usar uma ferramenta de automação visual que suporte chamadas de API REST, como o n8n. O processo geral é simples: | Passo | Ação | Detalhes | | :--- | :--- | :--- | | **1. Gerar Chaves de API** | Acesse o painel da Papo e vá para a seção de desenvolvedores para criar suas chaves. | Você terá uma **chave pública** (`pk_live_...`) para identificar sua conta e uma **chave secreta** (`sk_live_...`) para autenticação. A chave secreta é exibida apenas uma vez. | | **2. Consultar a Documentação** | Visite a [documentação oficial da API](https://papo.global/pt/docs) para ver todos os endpoints disponíveis. | A documentação detalha as URLs, os parâmetros necessários e os formatos de resposta para cada ação (enviar mensagem, listar contatos, etc.). | | **3. Implementar as Chamadas** | Escreva o código no seu sistema ou configure os blocos na sua ferramenta de automação. | As chamadas são feitas via HTTPS para a URL base `https://app.papo.global/api/v1`, enviando a chave secreta no cabeçalho de autorização. | | **4. Testar a Integração** | Realize testes para garantir que seu sistema está se comunicando corretamente com a Papo. | Verifique se as mensagens são enviadas e se os dados são recebidos conforme o esperado. | ## Perguntas Frequentes ### Preciso ser programador para usar a API? Sim, o uso direto da API exige conhecimento em programação. No entanto, ferramentas de automação como o n8n ou Make permitem que você se conecte à API através de uma interface visual, sem precisar escrever código, apenas configurando os blocos de ação e inserindo suas chaves. ### Onde encontro minhas chaves de API? As chaves de API podem ser geradas no painel de configurações da sua conta Papo, em uma seção dedicada a desenvolvedores. Lembre-se que a chave secreta (secret key) é mostrada apenas no momento da sua criação. Guarde-a em um local seguro, pois ela não poderá ser recuperada. Se perdida, você precisará revogá-la e criar uma nova. ### O que exatamente eu posso fazer com a API? Você pode executar diversas ações que faria manualmente na plataforma. A documentação oficial lista todos os endpoints, mas os principais são: enviar mensagens de texto via WhatsApp (`/messages`), listar contatos extraídos (`/contacts`), listar suas conexões de WhatsApp (`/instances`) e usar o motor de IA da Papo para gerar textos (`/ai/v1/complete`). ### Usar a API tem algum custo adicional? O acesso à API em si não gera custos adicionais em seu plano. No entanto, as ações que você executa através dela podem consumir recursos que são tarifados, como o envio de mensagens via API do WhatsApp ou a extração de novos leads com o Extrator. Para detalhes sobre os custos operacionais, consulte a página de preços no site da Papo. ### A API da Papo é do tipo REST ou SOAP? A API da Papo é uma API REST moderna. Ela utiliza os métodos HTTP padrão (GET, POST, etc.) e se comunica usando o formato JSON, que é leve e fácil de ser interpretado pela maioria das linguagens de programação e ferramentas de automação. ### Qual a diferença entre usar a API diretamente e usar uma integração pronta como a do Google Agenda? A API oferece flexibilidade total para que você crie qualquer tipo de integração. Já as integrações prontas, como a do Google Agenda ou Wavoip, são soluções pré-construídas pela Papo para casos de uso comuns. Elas são ativadas com poucos cliques, sem necessidade de código, mas são limitadas às funcionalidades que foram previamente desenvolvidas. ## Leia também - [Como Integrar a Wavoip para Fazer e Receber Ligações na Papo](/hc/papo/articles/integrar-wavoip-ligacoes-papo) - [Criando seu primeiro Flow de Automação do zero](/hc/papo/articles/criando-seu-primeiro-flow-automacao-do-zero) --- **[Comece grátis e explore as possibilidades →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=o-que-e-api-papo-para-que-serve&utm_content=pt_BR)** Conecte seus canais, configure a IA e comece a atender no mesmo dia.