Pular para o conteúdo

Zapier

O que faz

Um gatilho inicia um Zap quando algo acontece na Dotwick. Uma ação muda algo no seu espaço de trabalho. Uma busca consulta algo e entrega ao passo seguinte. Os gatilhos são webhooks que o app configura e remove para você, então você nunca registra um endpoint à mão.

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ção 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. Depois, no Zapier, adicione a conexão da Dotwick e cole a chave. O Zapier a testa com GET /v1/workspaces/current.

Os gatilhos exigem uma chave criada por um administrador ou pelo proprietário, porque cada um registra um webhook. Ações e buscas funcionam com os escopos acima.

Gatilhos

New Scan, New Code, Code Updated, New Form Submission e Scan Alert podem acompanhar um código, uma pasta (com as subpastas) ou uma tag. A Dotwick aplica o filtro antes de registrar uma entrega, então um Zap que observa uma pasta não é acordado pelo resto.

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

Ações e buscas

  • Create Code: um código URL dinâmico com nome, destino, pasta e tags.
  • Update Destination: aponte um código para um novo endereço.
  • Pause or Resume Code.
  • Add or Remove Tags em um ou mais códigos.
  • Create Folder.
  • Create Report: gere um relatório de estatísticas em PDF ou CSV e obtenha o link dele.
  • Find Code, Find Tag, Find Folder e Find Scan Alert.
  • Get Code Scans: os totais de escaneamento de um código em um período.

N escaneamentos em M minutos

Crie uma regra de alerta de escaneamento no app (por exemplo, 50 escaneamentos em 10 minutos em uma pasta) e use o gatilho Scan Alert. Toda vez que a regra dispara, o gatilho recebe um evento alert.fired com a regra, o escopo, o número de escaneamentos e a janela. Veja Tipos de evento para os campos dele.

O que o app registra

Quando um Zap com um gatilho é ligado, o app chama POST /v1/hooks. Ele apaga o hook com DELETE /v1/hooks/{id} quando o Zap é desligado. Cada hook é um webhook com um só evento, assinado e repetido como qualquer outro, e o espaço de trabalho pode ter até 100. GET /v1/hooks/samples/{event} devolve até 3 eventos recentes para você mapear os campos enquanto monta.

POST /v1/hooks
{  "event": "scan.created",  "targetUrl": "https://hooks.example.com/catch/12345/abcdef/",  "app": "zapier",  "filter": {    "folderId": "fld_7c2d9e41a05b3f68"  }}

Zaps prontos

Google Sheets, HubSpot e Slack passam pelo Zapier. Não há um complemento separado da Dotwick para eles; se você precisar de um nativo, avise-nos.

  • Adicione novos escaneamentos da Dotwick a linhas do Google Sheets
  • Salve respostas de formulário da Dotwick no Google Sheets
  • Registre novos códigos da Dotwick no Google Sheets
  • Crie contatos do HubSpot a partir de respostas de formulário da Dotwick
  • Publique alertas de escaneamento da Dotwick em um canal do Slack