Sincronização com o Notion
Vincule um modelo a um dos seus bancos de dados do Notion e cada envio vira uma linha lá — criada quando o formulário é enviado, atualizada quando o documento muda depois.
1 · Conectar seu espaço de trabalho
No Notion, crie uma conexão interna (em notion.so/my-integrations; as Configurações do Pocper levam até lá) e copie o token interno de API dela. Cole-o em Configurações → Integrações → Notion do Pocper. Só o dono da equipe pode fazer isso, e o token é guardado criptografado. Para trocá-lo, use Trocar o token na mesma página: o novo token é verificado antes de substituir o antigo.
Depois, compartilhe com essa conexão o banco de dados em que você quer escrever, ou a página em que ele está: abra-o no Notion, escolha ••• → Conexões → Adicionar conexões (em algumas versões, Conexões fica em ••• → Mais) e selecione a sua conexão. Sem esse passo, o banco de dados não aparece na lista do Pocper, e um link colado para ele é informado como não encontrado.
2 · Vincular um modelo a um banco de dados
Abra o painel Espaço de trabalho do modelo, escolha a aba Integração e clique em Vincular um banco de dados do Notion. Escolha um banco de dados que a sua conexão consegue ver (digite para buscar) ou cole o link dele. A primeira linha, Novo banco de dados, cria um dentro da página que você escolher, com uma coluna para cada campo, já mapeada, e uma coluna Pocper ID.
Cada campo ganha um seletor com as colunas de tipo compatível: um campo de data com uma coluna de data, uma caixa de seleção com uma caixa de seleção, texto com texto ou com o título. Em Detalhes do envio, você também pode mapear o cliente, quando foi enviado, o status e quem enviou.
Todo documento criado a partir do modelo copia essas configurações ao ser criado, e a aba Integração dele pode mudá-las só para ele. Uma mudança posterior no modelo só chega aos documentos novos; para os que ainda seguem as configurações anteriores, o modelo oferece Aplicar a eles também. Um documento criado antes de o modelo ser vinculado oferece Usar as configurações do modelo.
3 · O que acontece no envio
Quando um formulário é enviado — pela pessoa que o preenche, ou por você, ao marcá-lo como enviado — uma linha é criada em segundos. Em Sincronização, a aba Integração do documento passa a dizer quando foi a última sincronização, com um link para a linha, ou que uma alteração está esperando ou falhou; Sincronizar agora só aparece se o envio falhou ou se o documento nunca foi enviado. Para criar a linha assim que o documento existir, mude "Quando sincronizar" nas configurações de Integração do modelo.
Edições posteriores atualizam a mesma linha poucos segundos depois da última, e cancelar um documento atualiza a coluna de status dele.
A página da linha recebe um bookmark de volta para o documento e as respostas em forma de lista (as muito longas encurtadas, até cem). As configurações de Integração do modelo permitem desligar o corpo da página.
4 · Arquivos, assinaturas e duplicatas
Arquivos enviados e assinaturas podem ir para uma coluna Files & media: o arquivo é copiado para o Notion, até 20 MB (um maior é pulado e anotado no registro de sincronização). Mandá-los como links para uma coluna URL é uma chave separada, desligada por padrão, porque qualquer pessoa que veja a linha poderia abrir um link desses sem login no Pocper.
A proteção contra duplicatas impede que um envio tentado de novo apareça duas vezes: o Pocper grava o Pocper ID de cada documento numa coluna de texto com esse nome e encontra a linha por ele. Um banco de dados que já tem essa coluna a usa; se não tiver, a janela de vinculação a cria (a caixa vem marcada), ou as Configurações da aba Integração a criam em um clique.
5 · Alterações feitas no Notion
Ative a sincronização inversa na aba Integração e duas coisas voltam do Notion. Mudar a coluna de status para Submitted, Cancelled ou Collected leva o documento a esse status; editar uma célula mapeada para um campo de texto, caixa de seleção, data ou hora grava o valor no documento, e o histórico mostra a alteração como vinda do Notion. Se os dois lados mudaram uma célula, vale o valor do Notion — exceto enquanto um cliente ainda está preenchendo o formulário (não enviado, e salvo nos últimos dez minutos): aí fica o valor dele, a célula do Notion é restaurada e a aba Integração registra isso.
A sincronização inversa precisa de um webhook, configurado uma vez por equipe pelo dono em Configurações → Integrações → Notion: crie a URL do webhook, adicione-a como assinatura na aba Webhooks da sua conexão no Notion e cole de volta o token de verificação que o Notion envia. O Pocper nunca consulta o Notion por conta própria, então sem webhook as edições feitas no Notion ficam lá. Uma coluna que não pode receber um valor de volta — uma assinatura, um arquivo, qualquer campo de um documento bloqueado — é restaurada no Notion, e a aba Integração registra isso.
6 · Quando algo dá errado
Uma linha que não pôde ser enviada é tentada de novo, com intervalos cada vez maiores, por um dia. Se as tentativas se esgotarem, ou se o Notion a recusar de vez — token revogado, ou banco de dados não mais compartilhado —, a sincronização para, e o dono da equipe e quem vinculou o banco de dados recebem uma notificação no app que abre a aba Integração do documento. O erro ali diz o que fazer; a mensagem original do Notion fica em Mostrar a mensagem do Notion.
Uma sincronização parada volta sozinha assim que a causa é corrigida: quando você reconecta ou troca o token em Configurações, quando o Pocper volta a ler o banco de dados (Recarregar as propriedades do Notion, ao lado do título Campos, ou qualquer alteração salva na aba Integração) ou quando o documento é editado. No modelo, a linha Registro de sincronização conta as falhas e pode mostrar só elas, e uma linha como "3 documentos ainda não estão no Notion" tem um botão Enviar que envia todos — criando antes a coluna Pocper ID, se faltar; expanda-a para ver quais e por quê. Pausar a sincronização, ao lado do título Sincronização, para de enviar alterações até você clicar em Retomar a sincronização.