Enviar as respostas para outras ferramentas

Uma conexão (também chamada webhook) envia cada nova resposta de um formulário para outra ferramenta: o Zapier, o Make, uma folha do Google Sheets ou qualquer endereço que comece por https://. As conexões vão fazer parte do plano Pro; durante o acesso antecipado estão abertas a todas as contas (consulte Planos, preços e créditos).

Antes de começar

• A verificação em dois passos é obrigatória para adicionar, alterar ou ativar uma conexão, porque as respostas saem do Fillfold. Consulte Criar a conta e ativar a verificação em dois passos.
• Um formulário pode ter no máximo 2 conexões. Uma nova conexão começa desativada.
• Enviamos-lhe um e-mail sempre que uma conexão é adicionada, alterada, ativada ou recebe um novo segredo.

Adicionar uma conexão

1. Abra o formulário e escolha Conexões.
2. Cole o endereço que a sua ferramenta lhe dá em Endereço (URL).
3. Assinale Compreendo para onde vão as respostas e escolha Adicionar a conexão.
4. Copie o segredo mostrado em Segredo de assinatura, mostrado só uma vez e guarde-o na sua ferramenta.
5. Escolha Enviar um teste: são enviadas respostas de exemplo inventadas, nunca uma resposta real.
6. Escolha Ativar.

A lista Envios recentes mostra os últimos 50 envios, guardados durante 30 dias, com Tentar agora para um envio que falhou.

Zapier e Make

• Zapier: crie um Zap com o acionador Webhooks by Zapier, evento Catch Hook, e cole o URL no Fillfold. Confirme que o seu plano do Zapier inclui o Webhooks by Zapier.
• Make: adicione o módulo Webhooks, depois Custom webhook, e cole o endereço.

Cada pedido contém o formulário, a data da resposta, as perguntas (fields) e as respostas (answers). Os números chegam como números, as tabelas como linhas e os ficheiros apenas pelo nome.

Quando um cliente aceita um orçamento que preparou, as suas conexões recebem também o evento quote.accepted, com o PDF assinado em document.url se incluir as ligações para os PDF (consulte Enviar um orçamento para aceitação).

Google Sheets

1. Na sua folha, abra Extensões e depois Apps Script.
2. No Fillfold, escolha Copiar o script do Google Sheets e cole-o.
3. Coloque o seu segredo de assinatura na linha const SECRET.
4. Escolha Implementar, Nova implementação, tipo Aplicação Web, executada como o próprio utilizador, com acesso para qualquer pessoa. Copie o URL da aplicação Web.
5. Adicione-o como conexão e assinale Colocar a assinatura no corpo (para o Google Apps Script).

O script verifica a assinatura, ignora uma resposta que já tem e acrescenta um apóstrofo antes de qualquer texto que comece por =, +, - ou @, para que uma resposta nunca possa ser executada como fórmula na sua folha.

Guardar o PDF no Google Drive ou no Dropbox

Assinale Incluir uma ligação para o PDF. Cada resposta chega então com document.url, uma ligação privada válida durante 24 horas e 5 transferências. No Zapier, adicione um passo Google Drive ou Dropbox Upload File e indique essa ligação como ficheiro. No Make, adicione HTTP, Get a file e depois o módulo de carregamento. As cópias guardadas aí ficam fora das definições de eliminação do Fillfold (consulte a privacidade e os termos).

Verificar a assinatura

Cada pedido tem um cabeçalho Fillfold-Signature: t=1761400000,v1=.... Calcule um HMAC-SHA256 de t, um ponto e o corpo tal como chegou, com o seu segredo de assinatura como chave, e compare-o com v1. Recuse pedidos com mais de 5 minutos. Uma resposta enviada duas vezes mantém o mesmo id.

Se os envios falharem

Um envio que falha é tentado de novo durante cerca de 2 dias. Após 3 envios abandonados seguidos, a conexão é desativada e recebe um e-mail. Corrija o endereço, envie um teste e volte a ativá-la.