Conectar o Cord ao Make

O app do Cord para o Make permite iniciar um cenário quando um orçamento avança e criar ou atualizar dados no Cord a partir de qualquer outro app.

Conectá-lo

1. No Cord, abra Configurações › Integrações › Make e clique em Abrir o Cord no Make. Clique em Install, escolha sua organização do Make e confirme. O Make só permite instalar apps a quem é Admin, Owner ou App Developer dessa organização; se você não for, peça a quem for.
2. No Make, dentro de um cenário, adicione um módulo do Cord e clique em Create a connection › Save.
3. Na tela do Cord, escolha o espaço de trabalho e clique em Autorizar. Não há chaves para criar nem para colar.

Você precisa de acesso a Configurações nesse espaço para autorizar. Para cortar o acesso, abra a aba Chaves do Workbench de Desenvolvedores (o link Ver conexões autorizadas de Configurações › Integrações › Make leva você até lá) e revogue a conexão do Make, que aparece como Conexão autorizada.

O que você pode fazer

• Gatilho instantâneo: Watch Events, com os eventos do Cord que você escolher.
• Ações: criar, atualizar e consultar clientes; criar, consultar e enviar orçamentos; marcá-los como pagos e criar tarefas.
• Pesquisas: clientes e orçamentos.
• Make an API Call: qualquer outra operação da API do Cord.

Sem instalar o app

Você também pode conectar o Cord ao Make usando dois módulos que o Make já traz: Webhooks para receber eventos do Cord e HTTP para chamar a API do Cord.

Receber eventos do Cord

1. No seu cenário do Make, adicione o módulo Webhooks › Custom webhook, crie um webhook e copie a URL que o Make fornece.
2. No Cord, ative o Modo desenvolvedor em Sua conta › Preferências e abra a aba Webhooks do Workbench, a pílula Desenvolvedores no canto inferior direito.
3. Clique em Adicionar endpoint, escolha os eventos que interessam a você (por exemplo, quote.approved), cole a URL do Make e clique em Criar endpoint.
4. No Make, clique em Redetermine data structure e, no Cord, use o botão Testar do endpoint. O Make aprende o formato do evento e você já pode mapear campos como data.folio, data.total ou data.cliente.

Cada evento chega com id, event, created_at e data. Use o id para não processar duas vezes o mesmo evento se o Cord tentar a entrega novamente.

O Make não verifica a assinatura do Cord por você. Trate a URL do webhook como um segredo: não a compartilhe e, se achar que ela vazou, apague o endpoint no Cord e crie um novo.

Cada endpoint conta dentro do limite de webhooks do seu plano.

Criar ou atualizar dados no Cord

1. Crie no Cord uma chave secreta com permissão de escrita na aba Chaves do Workbench de Desenvolvedores.
2. No Make, adicione o módulo HTTP › Make a request.
3. Configure-o assim:
   • URL: o endpoint de que você precisa, por exemplo https://cordhq.app/api/v1/clientes.
   • Method: POST para criar, PATCH para atualizar.
   • Headers: Authorization com o valor Bearer sk_live_... e Content-Type com application/json.
   • Body type: Raw, conteúdo JSON, com os campos do recurso.
4. Se o cenário puder repetir tentativas, adicione o header Idempotency-Key com um valor fixo por operação, por exemplo o id do evento que a originou. Assim, uma nova tentativa não cria o registro duas vezes.

O que você pode fazer pelo Make:

• Criar um cliente com POST /api/v1/clientes ou atualizá-lo com PATCH /api/v1/clientes/{id}.
• Procurar um cliente por e-mail com GET /api/v1/clientes?email=....
• Criar um orçamento com POST /api/v1/cotizaciones.
• Enviá-lo ou marcá-lo como pago com POST /api/v1/cotizaciones/{id} e action.
• Criar uma tarefa com POST /api/v1/tareas.

Os campos de cada endpoint estão na documentação para desenvolvedores.