Pular para o conteúdo
PTEN

Make

Leve o que acontece no Cord para qualquer aplicativo do Make e crie dados no Cord a partir dos seus cenários.

O que faz

O aplicativo do Cord para o Make tem um gatilho instantâneo (Watch Events), ações para criar e alterar dados no Cord, buscas com paginação e um módulo universal para qualquer outra operação da API. Ele é autorizado com um clique em uma tela do Cord, sem chaves, e funciona em todas as zonas do Make.

Requisitos

Onde O que você precisa
Cord A permissão de Configurações no espaço de trabalho que você vai conectar. Qualquer plano.
Make Uma conta do Make. Para instalar o aplicativo, ser Administrador, Proprietário ou Desenvolvedor de aplicativos dessa organização do Make. As operações que seus cenários consomem são cobradas pelo Make de acordo com o seu plano do Make.
Cota Cada módulo de ação ou de busca gasta chamadas da cota mensal de API do seu plano do Cord. Veja Limites.

Conectar o aplicativo do Cord

O aplicativo do Cord para o Make é compartilhado por convite. Em Configurações › Integrações › Make está o botão Abrir o Cord no Make, que leva direto ao convite.

  1. Instale o aplicativo. Clique em Abrir o Cord no Make, depois em Instalar, escolha sua organização do Make e confirme. O Make só permite instalar aplicativos a quem é Administrador, Proprietário ou Desenvolvedor de aplicativos dessa organização.
  2. Crie a conexão. Em um cenário, adicione qualquer módulo do Cord e clique em Create a connection › Save.
  3. Autorize no Cord. Abre-se uma tela do Cord em que você escolhe o espaço de trabalho e clica em Autorizar. Não há chaves para criar nem para colar.

Quem autoriza precisa ter acesso a Configurações nesse espaço. O Make renova o acesso sozinho; para cortá-lo, revogue a conexão na aba Chaves do Cord Workbench, onde ela aparece como Conexão autorizada do Make.

Tipo Módulos
Gatilho instantâneo Watch Events: você escolhe os eventos do Cord e o cenário começa assim que eles acontecem.
Ações Create a Client, Update a Client, Get a Client, Create a Quote, Get a Quote, Send a Quote, Mark a Quote as Paid e Create a Task.
Buscas Search Clients e Search Quotes, com paginação.
Universal Make an API Call, para qualquer outra operação da API do Cord.

Cada Watch Events ativo cria o próprio webhook no Cord, com uma cota separada dos endpoints do seu plano.

Cenário do Make com três módulos encadeados: Cord › Watch Events, Cord › Get a Client e Google Sheets › Add a Row. Aberto, o webhook do gatilho com a conexão “Cord (Materiales del Valle)” e o evento “Quotes: Quote approved”.

O que circula e em que direção

Direção O que circula Quando
Do Cord para o Make O evento que você escolheu em Watch Events, com os dados do objeto. Na hora, cada vez que acontece no Cord.
Do Make para o Cord O que o módulo fizer: criar ou atualizar um cliente, criar ou enviar um orçamento, marcá-lo como pago ou criar uma tarefa. Quando o cenário é executado.
Buscas e consultas O Make lê clientes ou orçamentos para usá-los no módulo seguinte. Não altera nada. Quando o cenário é executado.

O que um módulo faz no Cord dispara os mesmos eventos que se uma pessoa o tivesse feito, com Quem originou: A API.

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 limite de segurança de 10 vezes o incluído
Webhooks criados pelos seus cenários 100 por organização, além dos endpoints de webhook do seu plano
Conexões autorizadas ativas 25 por aplicativo e por organização
  • O que gasta cota: cada módulo de ação, de busca ou Make an API Call, e registrar ou excluir o webhook do Watch Events. Receber eventos não gasta cota.
  • Quanto você já usou: em Configurações › Planos e assinatura › Assinatura, na linha Chamadas de API.
  • As requisições com HTTP › Make a request e uma chave sk_live_… também gastam cota; com sk_test_…, não.

Desconectar

Desativar um cenário: desative-o no Make. Para que o Cord deixe de enviar eventos a ele, exclua também o webhook dele na seção Webhooks do Make: ao excluí-lo, o Make o remove do Cord.

Cortar o acesso do Make ao Cord:

  1. Acesse Configurações › Integrações › Make e clique em Ver conexões autorizadas. Abre-se a aba Chaves do Cord Workbench.
  2. Procure a linha Conexão autorizada do Make, com a etiqueta OAuth.
  3. Clique em Revogar e confirme.

A partir desse momento, o Make não pode mais chamar a API com essa conexão, e os webhooks que os cenários dele tinham criado deixam de receber eventos. No Make, os módulos do Cord falham com um erro de autorização até você criar a conexão de novo. Se você usou a alternativa com Webhooks e HTTP, exclua o endpoint em Webhooks e revogue a chave em Chaves.

Alternativa: Webhooks e HTTP

Se preferir não instalar o aplicativo, o Make se conecta ao Cord usando dois módulos que o Make já traz:

Direção Módulo do Make O que você precisa no Cord
Cord → Make: um evento do Cord inicia seu cenário Webhooks › Custom webhook Um endpoint de webhook com a URL do Make
Make → Cord: seu cenário cria ou atualiza dados no Cord HTTP › Make a request Uma chave de API secreta com permissão de gravação

As duas coisas são configuradas no Cord Workbench (abas Webhooks e Chaves): se você não o vir, ative o Modo desenvolvedor em Sua conta › Preferências.

Receber eventos do Cord

  1. Crie o webhook no Make. No seu cenário, adicione Webhooks › Custom webhook, clique em Add, dê um nome a ele e copie a URL que o Make fornecer.
  2. Registre o endpoint no Cord. Abra Webhooks no painel de Desenvolvedores, cole a URL do Make e salve. O Cord mostra um segredo de assinatura uma única vez; o Make não o usa, mas guarde-o se pretende verificar assinaturas mais adiante.
  3. Escolha os eventos. Marque só os que o seu cenário precisa, por exemplo quote.approved ou invoice.paid.
  4. Mostre ao Make o formato do evento. No Make, clique em Redetermine data structure e, no Cord, clique em Testar no endpoint. O Make recebe um evento de exemplo e aprende os campos dele.
  5. Mapeie e ative. Use os campos nos módulos seguintes (por exemplo data.folio, data.total, data.cliente) e ative o cenário.

O que chega em cada evento

Cada evento é um JSON com quatro campos:

Campo O que é
id Identificador único do evento. É o mesmo se o Cord tentar a entrega de novo.
event O tipo de evento, por exemplo quote.paid.
created_at Quando aconteceu.
data Os dados do objeto: em um orçamento, id, folio, status, moneda, total, cliente, cliente_id e o link público.

A lista completa de eventos e os campos de cada um está em Webhooks para desenvolvedores.

Um endpoint ou vários

Você pode registrar um endpoint por cenário só com os eventos dele, ou um com vários eventos e um Router no Make que filtre por event. A primeira opção é mais fácil de manter; a segunda usa menos endpoints.

Os endpoints que você registra manualmente contam no limite de webhooks do seu plano: 16 no Grátis, no Starter e no Profissional; 32 no Scale; 100 no Developer.

Entregas e novas tentativas

Cada endpoint guarda um registro de entregas com o status, o tempo de resposta e a resposta do Make. Se o Make não responder, o Cord tenta a entrega de novo. Como o id não muda entre as tentativas, adicione no Make um filtro ou um armazenamento de dados (data store) para não processar duas vezes o mesmo id.

Trate a URL do webhook do Make como um segredo. O Make não verifica a assinatura do Cord, então qualquer pessoa que conheça a URL poderia enviar dados falsos para o seu cenário. Não a compartilhe e, se achar que ela vazou, exclua o endpoint no Cord, crie um webhook novo no Make e registre a URL nova.

Criar ou atualizar dados no Cord

  1. Crie uma chave. Em Chaves, no painel de Desenvolvedores, crie uma chave secreta com escopo de gravação. Ela é mostrada uma única vez; guarde-a na conexão do Make, não em um texto do cenário.
  2. Adicione HTTP › Make a request ao seu cenário.
  3. Configure-o:
    • URL: o endpoint, por exemplo https://cordhq.app/api/v1/clientes.
    • Method: POST para criar, PATCH para atualizar, GET para buscar.
    • Headers: Authorization com Bearer seguido da sua chave, e Content-Type com application/json.
    • Body type: Raw, com Content type JSON e os campos do recurso.
    • Parse response: ativado, para usar a resposta nos módulos seguintes.
  4. Evite duplicidades com o header Idempotency-Key (veja abaixo).

O que você pode fazer

Você quer Requisição
Buscar um cliente pelo e-mail antes de criá-lo GET /api/v1/clientes?email=client@example.com
Criar um cliente POST /api/v1/clientes com pelo menos empresa
Atualizar o contato de um cliente PATCH /api/v1/clientes/{id} com contacto, email, telefono etc.
Buscar um orçamento pelo número GET /api/v1/cotizaciones?folio=COT-00104
Criar um orçamento POST /api/v1/cotizaciones
Enviar, aprovar, recusar ou marcar um orçamento como pago POST /api/v1/cotizaciones/{id} com action: send, resend, approve, reject ou mark_paid
Criar uma tarefa POST /api/v1/tareas com titulo e, opcionalmente, due_date e cotizacion_id

Os campos de cada endpoint: Clientes, Orçamentos e Tarefas.

Evitar duplicidades

O Make pode tentar um módulo de novo. Para que uma nova tentativa não crie o mesmo cliente duas vezes, adicione o header Idempotency-Key com um valor fixo para essa operação, por exemplo o id do evento que a originou ou o id da linha da sua planilha. Se o Cord já recebeu essa chave com a mesma requisição, ele devolve o resultado original em vez de criar outro registro.

Chaves de teste

Com uma chave sk_test_…, seu cenário trabalha no ambiente de teste da sua conta, isolado dos seus dados reais. Use-a enquanto monta o cenário e troque-a pela sk_live_… ao terminar.

Exemplos de cenários

  • Orçamento aprovado → planilha: Custom webhook com quote.approved → Google Sheets › Add a row com número, cliente e total.
  • Formulário → cliente no Cord: Typeform › Watch responses → HTTP GET /api/v1/clientes?email= → se não existir, HTTP POST /api/v1/clientes.
  • Fatura paga → contabilidade: Custom webhook com invoice.paid → seu sistema contábil.
  • Pagamento em outra plataforma → marcar como pago no Cord: o gatilho da sua plataforma → HTTP GET /api/v1/cotizaciones?folio= → HTTP POST /api/v1/cotizaciones/{id} com {"action":"mark_paid"}.

Erros comuns

Resposta do Cord Causa O que fazer
401 A chave está faltando, foi copiada errada ou foi revogada. Verifique o header Authorization: Bearer sk_live_….
403 A chave é somente leitura. Crie uma chave com escopo de gravação.
404 O id não existe na sua organização. Verifique se você mapeou o id correto, e não o número.
409 invalid_state A ação não se aplica ao status atual, por exemplo aprovar um rascunho. Verifique o status do orçamento antes da ação.
422 idempotency_key_reused Você usou a mesma Idempotency-Key com outra requisição. Use uma chave diferente por operação.
429 Você ultrapassou o limite por minuto ou a cota mensal de API. Adicione uma pausa entre os módulos ou reduza a frequência. Verifique seu consumo em Configurações › Planos e assinatura; no Grátis, aguarde o mês seguinte ou mude para um plano superior.
“Você não pode conectar aplicativos aqui” ao autorizar Seu usuário não tem a permissão de Configurações nesse espaço. Peça a quem a tem que faça a autorização.

Mais em Erros da API.

Relacionadas