Como integrar a Papo com o Zapier usando API e webhooks

Q: 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.

Q: 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.

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)

No Zapier, crie um Zap e escolha Webhooks by Zapier como gatilho, na opção Catch Hook. O Zapier gera uma URL exclusiva.
Na Papo, crie um webhook nativo, um webhook do Kanban ou um Flow com ação de webhook.
Cole a URL do Zapier no campo de destino do webhook ou da ação.
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.
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)

No Zapier, use Webhooks by Zapier como ação, normalmente com uma requisição personalizada.
Aponte para a base https://app.papo.global/api/v1.
Inclua o header Authorization: Bearer sk_live_... ou X-Papo-Secret-Key e, se quiser, X-Papo-Public-Key.
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.
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.