Make

O que faz

Um módulo Watch inicia um cenário no momento em que algo acontece na Dotwick. Os outros módulos criam ou mudam coisas no seu espaço de trabalho, ou as consultam. Os módulos Watch são instantâneos: o Make registra um webhook na Dotwick quando você liga o cenário e o remove quando você o desliga.

Exige uma chave de API, então o seu plano precisa incluir acesso à API e webhooks (veja a página de preços). O app usa os mesmos escopos, limites de função, restrições de pasta e limites de requisições de qualquer outra chave.

Conecte o seu espaço de trabalho

Na Dotwick, abra Settings → API e crie uma chave com o preset For Zapier / Make. Ele pede estes escopos: codes:read, codes:write, analytics:read, submissions:read, folders:read, folders:write, tags:read, tags:write, webhooks:read, webhooks:write. No Make, adicione uma conexão da Dotwick e cole a chave. O Make a testa com GET /v1/workspaces/current.

Os módulos Watch exigem uma chave criada por um administrador ou pelo proprietário, porque cada um registra um webhook.

Módulos Watch

Os cinco primeiros podem acompanhar um código, uma pasta (com as subpastas) ou uma tag. Para acompanhar uma só regra de alerta de escaneamento, adicione no cenário um filtro pelo ID da regra.

• Watch Scans: uma pessoa escaneia um código. Bots e prévias de link nunca disparam.
• Watch New Codes: um código é criado no app ou pela API.
• Watch Code Updates: o destino, o conteúdo, o nome, o design ou as regras de um código mudam.
• Watch Form Submissions: alguém responde a um código de formulário ou a um bloco de formulário.
• Watch Scan Alerts: um alerta de escaneamento dispara: todo escaneamento, N escaneamentos em M minutos ou nenhum escaneamento por D dias.
• Watch Bulk Runs: uma execução em massa termina, com as contagens.

Ações e buscas

• Create a Code, Update a Destination, Pause or Resume a Code e Add or Remove Tags.
• Create a Folder.
• Create a Report: gere um relatório de estatísticas em PDF ou CSV e obtenha o link dele.
• Search Codes, Search Tags, Search Folders e List Scan Alerts.
• Get Code Scans: os totais de escaneamento de um código em um período.

Como os webhooks são tratados

Cada módulo Watch registra um hook com POST /v1/hooks e o remove com DELETE /v1/hooks/{id}. Um hook é um webhook com um só evento, assinado e repetido como qualquer outro. Um espaço de trabalho pode ter até 100 hooks, e a tela Developers os lista à parte dos seus próprios endpoints.

O módulo Scan Alert recebe um evento alert.fired. Veja Tipos de evento para os campos dele.