Para conectar a ConverZAP ao Zapier, crie uma chave da API pública em Configurações → API pública, abra um Zap no Zapier, escolha o app ConverZAP e cole a chave ao conectar a conta. A partir daí, os gatilhos e as ações da ConverZAP ficam disponíveis para ligar o WhatsApp, os contatos e o funil aos outros apps do Zapier. O app ConverZAP está publicado no diretório do Zapier, com o selo Beta. Os detalhes da integração estão na página integração ConverZAP × Zapier.
Antes de começar
- Um plano com a API pública: Vendas (R$ 497/mês), Completo (R$ 997/mês) ou Enterprise. O plano Essencial não inclui a API. Compare os planos.
- No teste grátis de 7 dias, a chave é só de leitura: gatilhos e buscas funcionam, mas ações que escrevem na ConverZAP, como criar contato ou enviar mensagem, não.
- Uma conta no Zapier. O uso do Zapier é cobrado pelo próprio Zapier, conforme o plano da empresa lá.
- Para as ações de WhatsApp, um número conectado à ConverZAP. Se ainda não houver, siga o guia conectar o WhatsApp pela API oficial.
Passo 1: criar a chave na ConverZAP
- Na ConverZAP, abra Configurações → API pública.
- Clique em “Criar chave” e dê um nome que identifique a integração, por exemplo “Zapier”.
- Marque só os escopos que o Zap vai usar: os de leitura para gatilhos e buscas e os de escrita para as ações (contatos, conversas e mensagens, funil ou automações, conforme o caso).
- Crie a chave e copie o valor, que começa com
czk_live_. A ConverZAP mostra a chave uma única vez: guarde-a em lugar seguro, como um gerenciador de senhas.
Passo 2: conectar no Zapier
- No Zapier, clique em “Create Zap”.
- No gatilho ou na ação, procure e escolha o app ConverZAP.
- Escolha o evento, por exemplo New Contact como gatilho ou Send WhatsApp Template como ação.
- Ao conectar a conta (“Sign in”), cole a chave da API pública e confirme.
- Preencha os campos do passo e use “Test” para conferir o resultado com dados reais.
- Revise o Zap e clique em “Publish” para ligá-lo.
A conta conectada pode ser reaproveitada em outros Zaps. Mesmo assim, a boa prática é criar uma chave por integração: se for preciso revogar uma, as demais seguem funcionando.
Gatilhos, ações e buscas
- Gatilhos: New Contact (novo contato), New Deal (novo negócio), New Conversation (nova conversa) e Conversation Needs a Human (conversa aguardando humano).
- Ações: Create or Update Contact, Add Labels to Contact, Send WhatsApp Text, Send WhatsApp Template, Add Internal Note (nota interna na conversa), Create Deal, Move Deal (mover de etapa no funil) e Add Contact to Automation (inscrever numa automação).
- Buscas: Find Contact (por telefone ou texto) e Find or Create Contact.
Exemplos de Zaps
A página do app no Zapier mostra modelos prontos, que já vêm com o gatilho e a ação escolhidos:
- Criar ou atualizar contatos na ConverZAP a partir de novas linhas do Google Sheets.
- Criar ou atualizar contatos a partir de respostas do Typeform.
- Criar ou atualizar contatos a partir de novos leads do RD Station.
- Enviar uma mensagem no Slack a cada novo negócio na ConverZAP.
- Enviar um e-mail pelo Gmail quando uma conversa da caixa de entrada precisa de humano.
Limites e boas práticas
- Consulta periódica: os gatilhos funcionam por polling. O Zapier consulta a ConverZAP de tempos em tempos, e o intervalo depende do plano do Zapier, não da ConverZAP.
- Janela de 24 h: Send WhatsApp Text só envia dentro da janela de 24 h da Meta. Fora dela, use Send WhatsApp Template com um template aprovado.
- Opt-out: as regras da API valem no Zapier. Contato que pediu para sair não recebe mensagem pelo Zap.
- Idempotência: os envios de mensagem usam chave de idempotência. Repetir um passo não envia a mensagem duas vezes.
- Uma chave por integração: só com os escopos necessários.
Problemas comuns
Chave inválida ou revogada
Se a chave foi copiada pela metade ou revogada, o Zapier não consegue conectar a conta. Crie uma nova chave em API pública e reconecte a conta no Zapier com ela.
Escopo faltando
A conexão funciona, mas um passo é recusado por falta de permissão. Crie uma chave com o escopo daquele gatilho ou ação e troque a conta conectada no Zap.
Ação de escrita no teste grátis
No teste, a chave é só de leitura. Gatilhos e buscas funcionam; ações como criar contato, enviar mensagem ou mover negócio, não. Para usá-las, assine o plano Vendas, Completo ou Enterprise.
Mensagem de texto fora da janela de 24 h
Send WhatsApp Text não envia se o contato não escreveu nas últimas 24 h. Troque a ação por Send WhatsApp Template e escolha um template aprovado.
Dica: quem usa n8n pode ligar a ConverZAP pelo node comunitário n8n-nodes-converzap, com a mesma chave da API pública. O app do Make está em breve.
Veja também
- Integração ConverZAP × Zapier
- Documentação das integrações
- App ConverZAP no Zapier
- Templates do WhatsApp
Zapier é marca da Zapier, Inc. WhatsApp e Meta são marcas da Meta Platforms, Inc. A ConverZAP é Tech Provider verificado pela Meta e não é afiliada à Meta nem ao Zapier.