Zapier
Conecte o Cord a milhares de apps sem escrever código: seus Zaps começam quando algo acontece no Cord e podem criar dados no Cord.
O que faz
O app do Cord para o Zapier tem gatilhos instantâneos (um Zap começa assim que algo acontece no Cord), ações (o Zap cria ou altera dados no Cord) e buscas (o Zap encontra um cliente ou um orçamento antes de agir). A autorização é feita com um clique em uma tela do Cord: você não cria nem cola nenhuma chave.
Requisitos
| Onde | O que você precisa |
|---|---|
| Cord | A permissão Configurações no espaço de trabalho que você vai conectar. Qualquer plano. |
| Zapier | Uma conta no Zapier. O que você pode montar (quantos Zaps, quantas etapas) depende do seu plano do Zapier. |
| Cota | Cada ação e cada busca consome chamadas da cota mensal de API do seu plano do Cord. Veja Limites. |
Conectar o app do Cord
O app do Cord para o Zapier é compartilhado por convite. Em Configurações › Integrações › Zapier fica o botão Abrir o Cord no Zapier, que leva direto ao convite.
- Aceite o convite. Clique em Abrir o Cord no Zapier e aceite. O Zapier adiciona o Cord aos seus apps.
- Crie um Zap. Escolha o Cord como gatilho ou como ação e clique em Conectar.
- Autorize no Cord. Abre-se uma tela do Cord onde você escolhe o espaço de trabalho e clica em Autorizar. A tela informa o que o Zapier poderá e não poderá fazer: ele não pode ver senhas nem dados de cartão, mudar seu plano nem administrar sua equipe.
- Teste o Zap. O Zapier traz um evento de exemplo para você mapear os campos nas etapas seguintes.
O Zapier renova o acesso sozinho. A conexão aparece no Cord como Conexão autorizada do Zapier, na aba Chaves do Cord Workbench.
O que o app inclui
| Tipo | O que você pode fazer |
|---|---|
| Gatilhos instantâneos | Orçamento criado, enviado, aberto pelo cliente, aprovado, recusado ou pago; pagamento parcial recebido; fatura paga; cliente novo; ou New Event, para escolher qualquer um dos 41 eventos do Cord. |
| Ações | Criar cliente, atualizar cliente, criar orçamento (com itens, moeda, condições, validade e a opção de enviá-lo na hora), enviar orçamento, marcar orçamento como pago e criar tarefa. |
| Buscas | Cliente por e-mail exato ou por nome, e orçamento por número. |
A lista dos 41 eventos está em Gatilhos e em Webhooks para desenvolvedores.
O que é sincronizado e em que direção
| Direção | O que é sincronizado | Quando |
|---|---|---|
| Do Cord para o Zapier | O evento que você escolheu, com os dados do objeto: número, cliente, total, moeda, status e, em um orçamento, o link público. | Na hora, sempre que acontece no Cord. |
| Do Zapier para o Cord | O que a ação fizer: um cliente novo ou atualizado, um orçamento novo ou enviado, um pagamento registrado ou uma tarefa. | Quando o Zap é executado. |
| Buscas | O Zapier lê um cliente ou um orçamento para usá-lo na etapa seguinte. Não altera nada. | Quando o Zap é executado. |
O que uma ação faz no Cord dispara os mesmos eventos que dispararia se uma pessoa o fizesse, com Quem originou: A API. Se você tiver workflows ou Zaps escutando esses eventos, eles também são executados.
Limites
| Limite | Valor |
|---|---|
| Chamadas de API por mês | Grátis 100, Starter 1.000, Profissional 5.000, Scale 10.000, Developer 50.000 |
| Ao ultrapassar a cota | No Grátis, as chamadas são recusadas até o mês seguinte; a partir do Starter, são cobradas como excedente, com um teto de segurança de 10 vezes o que está incluído |
| Webhooks criados pelos seus Zaps | 100 por organização, além dos endpoints de webhook do seu plano |
| Conexões autorizadas ativas | 25 por app e por organização |
- O que consome cota: cada ação e cada busca (pelo menos uma chamada; algumas ações leem o orçamento depois de alterá-lo) e registrar ou excluir o webhook ao ligar ou desligar um Zap. Receber eventos não consome cota.
- Quanto você já usou: em Configurações › Planos e assinatura › Assinatura, linha Chamadas de API.
- Cada Zap ativo com um gatilho do Cord cria o próprio webhook no Cord; ao desligar o Zap, o Zapier o exclui.
Desconectar
Há dois níveis, conforme você queira desligar um Zap ou cortar completamente o acesso do Zapier.
Desligar um Zap: desligue-o ou exclua-o no Zapier. O Zapier exclui no Cord o webhook que esse Zap tinha criado; os outros Zaps continuam funcionando.
Cortar o acesso do Zapier ao Cord:
- Acesse Configurações › Integrações › Zapier e clique em Ver conexões autorizadas. Abre-se a aba Chaves do Cord Workbench.
- Procure a linha Conexão autorizada do Zapier, com a etiqueta OAuth.
- Clique em Revogar e confirme.
A partir desse momento, o Zapier não pode mais chamar a API com essa conexão, e os webhooks que os Zaps dele tinham criado deixam de receber eventos. No Zapier, os Zaps do Cord falham com um erro de autorização até você conectar a conta novamente. Se também quiser remover a conta do Zapier, exclua-a em My Apps no Zapier.
Alternativa: Webhooks by Zapier
Se preferir não instalar o app, você pode conectar o Zapier com os módulos genéricos. O Webhooks by Zapier é um app do Zapier disponível nos planos pagos dele.
- Crie o Zap. No Zapier, escolha como gatilho Webhooks by Zapier › Catch Hook e copie a URL que ele fornece.
- Registre o endpoint no Cord. Ative o Modo desenvolvedor (Sua conta › Preferências), abra a aba Webhooks do Workbench, cole a URL do Zapier e salve.
- Escolha os eventos, por exemplo
quote.approved. - Envie um evento de teste. Clique em Testar no endpoint do Cord e, no Zapier, em Test trigger. O Zapier mostrará os campos:
event,data__folio,data__total,data__clienteetc. - Adicione as ações do Zap e ative-o.
Cada evento traz id, event, created_at e data. Se você registrar vários eventos em um endpoint, adicione uma etapa Filter by Zapier ou Paths pelo campo event.
O Zapier não verifica a assinatura do Cord. Trate a URL do Catch Hook como um segredo; se achar que ela vazou, exclua o endpoint no Cord e crie um Zap novo.
Os endpoints que você registra dessa forma contam no limite de webhooks do seu plano: 16 no Grátis, no Starter e no Profissional; 32 no Scale; 100 no Developer.
- Em API, dentro do painel de Desenvolvedores, crie uma chave secreta com escopo de escrita.
- No seu Zap, adicione Webhooks by Zapier › Custom Request.
- Configure Method (
POST,PATCHouGET), URL (por exemplohttps://cordhq.app/api/v1/clientes), Data em JSON e os HeadersAuthorization: Bearer+ sua chave eContent-Type: application/json. - Adicione o header
Idempotency-Keycom um valor único por operação (por exemplo, o id do registro que originou o Zap) para que uma nova tentativa não duplique dados.
As requisições disponíveis são as mesmas do Make: buscar e criar clientes, criar orçamentos, enviá-los, aprová-los ou marcá-los como pagos, e criar tarefas. Os campos estão na documentação para desenvolvedores. Essas requisições também consomem a cota mensal de API.
Exemplos
- Orçamento pago → Google Sheets: gatilho Quote Paid → Google Sheets › Create Spreadsheet Row. (Se você só quer a planilha, a integração direta com o Google Sheets não consome cota.)
- Novo lead no seu formulário → cliente no Cord: seu app de formulários → Find Client por e-mail → se não existir, Create Client.
- Orçamento aprovado → projeto novo: gatilho Quote Approved → Asana, Trello ou ClickUp › Create task.
Problemas comuns
| Mensagem ou sintoma | O que fazer |
|---|---|
| “Você não pode conectar apps aqui” ao autorizar | Seu usuário não tem a permissão Configurações nesse espaço. Peça a quem a tem para autorizar, ou entre com outra conta. |
| “O endereço de retorno desta solicitação não corresponde…” | Comece a conexão de novo pelo Zapier, não por um link salvo. |
| O Zap falha com um erro de autorização | A conexão foi revogada no Cord. Conecte novamente a conta do Cord no Zapier. |
| O Zap falha com 429 | Você ultrapassou o limite por minuto ou a cota mensal de API. Confira seu consumo em Configurações › Planos e assinatura; no Grátis, aguarde o mês seguinte ou mude de plano. |
| “Suas integrações já criaram 100 inscrições de webhook, o máximo por organização.” | Desligue os Zaps, cenários ou fluxos do n8n que você não usa mais para liberar espaço. |
| O gatilho não recebe eventos | Verifique se o Zap está ligado e se o evento acontece depois de ligá-lo: um Zap não recebe os eventos anteriores. Para testar, gere o evento real, por exemplo enviando um orçamento para seu próprio e-mail. |