**Para integrar a Papo (https://papo.global/) ao Zapier, você usa a API REST da Papo para executar ações e os webhooks nativos ou Flows para enviar eventos da Papo ao Zapier. Assim, um evento como nova conversa ou negócio ganho no Kanban pode disparar automaticamente ações em centenas de aplicativos conectados ao Zapier.** A Papo não depende de um conector exclusivo para funcionar com o Zapier: a plataforma expõe endpoints REST e permite criar webhooks, que são exatamente os mecanismos que o Zapier usa para receber e enviar dados. Este guia mostra a conexão em duas direções: eventos da Papo como gatilhos no Zapier e chamadas à API da Papo como ações. ## Resumo da integração | Recurso | O que faz | Onde configurar | | :--- | :--- | :--- | | API REST Papo | Autenticada por chave secreta; permite listar conta, instâncias, contatos, enviar mensagens e usar IA | `https://app.papo.global/api/v1` com chave gerada no painel em `https://app.papo.global/developers` | | Webhook nativo | Envia eventos da conta para uma URL configurada | Módulo de Automações | | Webhook Kanban | Envia eventos do funil de vendas para uma URL configurada | Módulo Kanban | | Flows | Cria automações visuais; um gatilho como nova conversa pode chamar uma ação de webhook | Módulo Flows | | Webhooks by Zapier | Recebe o webhook da Papo e dispara ações em centenas de apps | Zapier | ## O que você precisa antes de começar - Uma conta Papo com acesso ao painel. - Uma conta Zapier. - A chave secreta da API Papo, criada em `https://app.papo.global/developers`. - Uma URL de webhook do Zapier para receber os eventos. A chave secreta segue o formato `sk_live_...` e é exibida apenas uma vez no momento da criação. Guarde-a em local seguro, porque ela autentica as chamadas à API. ## Como funciona a integração em duas direções ### Da Papo para o Zapier (gatilho) 1. No Zapier, crie um Zap e escolha **Webhooks by Zapier** como gatilho, na opção **Catch Hook**. O Zapier gera uma URL exclusiva. 2. Na Papo, crie um webhook nativo, um webhook do Kanban ou um Flow com ação de webhook. 3. Cole a URL do Zapier no campo de destino do webhook ou da ação. 4. Configure o evento que deve disparar o envio. Para novas conversas, use um Flow com gatilho **Nova conversa**. Para eventos do funil, use os webhooks do Kanban. 5. No Zapier, adicione a ação desejada: enviar e-mail, criar linha em planilha, registrar lead em outro CRM, notificar um canal do Slack etc. ### Do Zapier para a Papo (ação) 1. No Zapier, use **Webhooks by Zapier** como ação, normalmente com uma requisição personalizada. 2. Aponte para a base `https://app.papo.global/api/v1`. 3. Inclua o header `Authorization: Bearer sk_live_...` ou `X-Papo-Secret-Key` e, se quiser, `X-Papo-Public-Key`. 4. Escolha o endpoint de acordo com a ação: `POST /api/v1/messages` para enviar mensagem de WhatsApp, `GET /api/v1/contacts` para listar contatos do Extrator, `GET /api/v1/instances` para consultar conexões de WhatsApp, entre outros. 5. Mapeie os dados vindos de etapas anteriores do Zap para o corpo da requisição. ## Exemplos práticos de automação - **Nova conversa no WhatsApp gera lead em outro sistema:** um Flow dispara um webhook para o Zapier sempre que uma nova conversa chega em uma caixa de entrada. O Zapier formata os dados e cria o lead no CRM da empresa. - **Negócio ganho no Kanban atualiza uma planilha:** o webhook do Kanban envia o evento para o Zapier, que registra o card ganho em uma planilha ou em um sistema financeiro. - **Mensagens programáticas:** o Zapier chama `POST /api/v1/messages` para enviar um lembrete ao cliente após ele preencher um formulário em outro app. - **Respostas de IA:** o Zapier pode chamar `POST /api/ai/v1/complete` para gerar uma resposta com o prompt da conta Papo e usar o resultado em outro fluxo. ## Para quem essa integração é útil - **Times de vendas** que precisam sincronizar negócios ganhos com planilhas, CRMs ou ferramentas de faturamento. - **Equipes de suporte** que usam vários canais e querem registrar conversas em sistemas de help desk. - **Operações de marketing** que disparam campanhas a partir de eventos do CRM, como um novo contato extraído. - **Empresas com stack diversa** que querem reduzir trabalho manual entre WhatsApp, CRM, e-mail e planilhas. ## Perguntas frequentes ### Preciso de um conector oficial da Papo no Zapier? Não é necessário. A integração usa a API REST e os webhooks da Papo, que funcionam com o app Webhooks by Zapier. Os detalhes de endpoints disponíveis estão na documentação da API. ### Quais eventos da Papo podem iniciar um Zap? Você pode usar Flows para eventos como nova conversa e webhooks nativos ou do Kanban para eventos de automação e do funil de vendas. A lista completa de webhooks disponíveis aparece no painel da Papo. ### Como autentico a API da Papo no Zapier? Use a chave secreta no header `Authorization: Bearer sk_live_...` ou no header `X-Papo-Secret-Key`. A chave pública (`pk_live_...`) é opcional quando enviada junto com a secreta. ### Posso enviar mensagens de WhatsApp pelo Zapier? Sim. Você pode fazer uma requisição para `POST /api/v1/messages` informando o número de destino e o texto. A mensagem sai pelo WhatsApp conectado à sua conta Papo. ### O Zapier pode atualizar cards do Kanban? Sim, por API. A Papo permite listar cards, criar card em uma etapa, mover cards e marcar como ganhos ou perdidos, o que pode ser acionado pelo Zapier. ### O que fazer se o webhook não chegar ao Zapier? Confirme que o webhook ou Flow está ativo, que a URL do Zapier foi colada corretamente e que a chave usada nas chamadas está válida. Os logs de execução dos Flows ajudam a identificar o erro. ## Leia também - [Automações na Papo: Regras, Macros, Flows e Webhooks – qual usar?](/hc/papo/articles/automacoes-papo-regras-macros-flows-webhooks) - [Como usar a API da Papo para listar conversas e enviar mensagens programáticas](/hc/papo/articles/usar-api-papo-listar-conversas-enviar-mensagens-programaticas) --- **[Comece grátis e conecte seus canais →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=integrar-papo-zapier-api-webhooks&utm_content=pt_BR)** Crie sua conta gratuita na Papo para centralizar atendimento, CRM e automações em um só painel.