Recolher respostas

Um site no Solta é só ficheiros, sem um servidor seu por trás, por isso um formulário nele normalmente não teria para onde enviar o que as pessoas escrevem. O Solta guarda as respostas por si.

O formulário

Envie para /_solta/forms/ seguido de um nome à sua escolha, no endereço próprio do seu site. Use um nome fixo no código, para que o Solta o consiga encontrar. Quando o site é guardado, o Solta encontra o formulário, e ele começa logo a recolher: as respostas chegam ao separador Respostas do site. Definições do site → Formulários lista todos os formulários para onde o código envia, cada um com um interruptor para o desligar, e com Enviar-me cada resposta por e-mail, se quiser receber as respostas à medida que chegam. Um formulário que desligue fica desligado. Um site publicado sem conta não guarda nada até alguém iniciar sessão para ficar com ele, porque ainda ninguém poderia ler as respostas.

<form method="post" action="/_solta/forms/signup">
  <input name="email" type="email" required />
  <textarea name="note"></textarea>
  <button>Send</button>
</form>

É um formulário simples, e funciona: o visitante vê uma página curta a dizer que a resposta foi enviada, ou porque não foi. Se preferir enviar JSON, envie JSON para o mesmo endereço: cada campo passa a ser uma coluna.

O que a página deve dizer a seguir

Diga à pessoa, com clareza, o que aconteceu. Um código 2xx significa que a resposta foi guardada: diga que foi enviada e quem a vai ver. Quando não foi, o JSON diz porquê, e a página pode guardar a resposta no dispositivo do visitante e dizer qual foi o motivo:

• 409 com not_collecting: esta página não está a recolher respostas neste momento (o formulário está desligado, ou ainda ninguém iniciou sessão para ficar com o site).
• 429 com monthly_limit: esta página chegou ao limite de respostas deste mês. Nos planos Free e Plus, isso acontece 100 respostas depois do limite do mês, porque essas 100 ainda são recebidas.
• Nenhum código, porque o pedido falhou: não há ligação.
• Qualquer outra coisa: mostre o error do JSON e deixe a pessoa tentar novamente.

Porquê o seu próprio endereço

A ação é um caminho, e não um URL noutro sítio. É de propósito: um formulário que envia para outra origem faz um pedido entre origens diferentes, que o navegador bloqueia ou obriga a contornar, e um site no Solta não tem um servidor seu para isso. O seu site envia para o seu site.

Ler as respostas

Abra o site e encontra um separador Respostas ao lado de Comentários e Versões, com as mais recentes primeiro e um botão CSV que as transfere como folha de cálculo. É visível apenas para si. Nos planos Free e Plus, recebe um e-mail por dia com o que chegou. Nos planos Pro e Team, cada resposta chega por e-mail assim que é enviada, com o que diz: as primeiras 5 de cada hora uma a uma, e as restantes dessa hora juntas, à hora certa. Desligue Enviar-me cada resposta por e-mail num formulário, e as respostas dele passam para o e-mail diário. Todos estes e-mails têm Parar estes emails para este site no rodapé, e Definições do site → Formulários volta a ligá-los. Num espaço de trabalho, cada proprietário e administrador escolhe por si.

Um valor que começa por =, +, - ou @ é uma fórmula para uma folha de cálculo, e as respostas vêm de desconhecidos. Acrescentamos um carácter antes desses valores, para que o texto continue legível e a fórmula não seja executada.

Os limites

Os formulários de uma conta recolhem 100 respostas por mês no Free e 500 no Plus, somando todos os seus sites. Nos planos Free e Plus, o Solta guarda-as durante 30 dias e envia-lhe um e-mail por dia com o que chegou. Os formulários desses planos não podem receber palavras-passe, números de cartão nem códigos. Acima das respostas do mês, até mais 100 são guardadas da mesma forma, bloqueadas: o separador Respostas e o e-mail diário dizem quantas são, e podem ser lidas nos planos Pro e Team. O Pro recolhe 1000 por mês, e o Team 10 000. Ambos lhe enviam cada uma por e-mail, a não ser que desligue essa opção, e guardam-nas durante o tempo que escolher. Além disso: 60 campos, 8 KB por campo e 60 respostas por hora a partir de um mesmo endereço, o que é muito mais do que uma pessoa preenche e muito menos do que um script gostaria.

No Pro e no Team, as respostas ficam guardadas durante um ano por predefinição, e depois são eliminadas. Escolhe, para cada formulário, no separador Respostas: 30 dias, um ano, ou até as eliminar. São suas, e pode exportá-las quando quiser.

Slack e folhas de cálculo Google

No Pro e no Team, Definições do site → Formulários também pode enviar cada resposta para um canal do Slack ou para uma folha de cálculo Google, com tudo o que diz, de todos os formulários desse site. Quem consegue ler o canal ou a folha consegue ler o que as pessoas escreveram, por isso escolha um que possa partilhar. Cada um é testado quando o liga, e as definições dizem quando chegou a última resposta, ou porque não chegou.

Slack: cole um URL de incoming webhook (no Slack, Apps → Incoming Webhooks → Add to Slack), ou escolha um canal que já tenha ligado em Definições → Chaves e ligações. Primeiro, o Solta publica lá uma linha, para confirmar que chega.

Folhas de cálculo Google: um pequeno script que acrescenta à folha recebe as linhas. Assim, o Solta nunca inicia sessão na sua conta Google nem vê mais nada no seu Drive.

1. Em Definições do site → Formulários, escolha Folha de cálculo Google e copie o script. Leva o segredo desta ligação.
2. Abra a folha e, depois, Extensões → Apps Script. Substitua o que lá estiver pelo script, e guarde.
3. Implementar (Deploy) → Nova implementação (New deployment). Tipo: Aplicação Web. Executar como: Eu. Quem tem acesso: Qualquer pessoa. Autorize quando a Google pedir.
4. Cole no Solta o endereço da aplicação Web, terminado em /exec, e ligue.

O Solta verifica se o script responde, sem escrever nenhuma linha. Depois, cada resposta acrescenta uma linha num separador com o nome do formulário, com uma coluna para cada campo, e vai assinada, para que o script recuse tudo o que não venha do Solta. Um valor que seria uma fórmula fica guardado como texto.

Uma resposta automática

No Pro e no Team, um formulário pode enviar uma resposta automática curta, escrita por si, a quem o preenche, para que a pessoa saiba que chegou. Só é enviada quando a resposta tem exatamente um endereço de e-mail, num campo para o e-mail da própria pessoa, e no máximo uma vez por dia para cada endereço, a partir de cada site. O assunto e as palavras são seus, em texto simples, sem links além do endereço próprio do seu site. Acrescentamos o nome e o endereço do site, e uma forma de a pessoa deixar de as receber ou de as denunciar. Nada do que escreveu entra na mensagem. Quando alguém responde a essa mensagem, a resposta pode chegar ao seu e-mail, se quiser.

É enviada a partir do endereço do Solta para e-mails desencadeados por visitantes, nunca em nome do site. Um site envia no máximo 50 por hora e 300 por dia, e um endereço cujo e-mail foi devolvido, que marcou os nossos e-mails como spam ou que pediu para não receber mais nunca recebe outra. Se as pessoas marcarem os e-mails de um site como spam, as respostas automáticas dele são suspensas e recebe um aviso.

Inscrições na newsletter

No Pro e no Team, um site pode ter uma lista de e-mails. Definições do site → Newsletter configura-a em três passos. Ligue Inscrições na newsletter. Acrescente um formulário de inscrição, com Pedir à sua IA para o adicionar (uma mensagem para colar no chat onde cria o site) ou com o HTML. E confirme que está lá: isso lê a versão online à procura de um formulário que envie para /_solta/subscribe. Se a versão online tiver um formulário assim enquanto as inscrições estão desligadas, o ecrã avisa, e o conector também avisa quando guarda um. À mão, um formulário como este pode ficar em qualquer parte do site:

<form method="post" action="/_solta/subscribe">
  <input type="email" name="email" required>
  <button>Subscribe</button>
</form>

Funciona sem script. Com um script, envie { email } como JSON para o mesmo endereço e mostre “confirme o seu e-mail”. Enviamos a cada endereço um link de confirmação, e só quem o usa entra na lista. Assim, um endereço que outra pessoa escreveu recebe um e-mail nosso uma vez, e nunca mais. O mesmo endereço inscrito duas vezes recebe um só e-mail.

Pode transferir a lista como folha de cálculo (CSV), só com os endereços confirmados, cada um com o seu próprio link para cancelar a inscrição, para pôr no que enviar. Usar esse link elimina o endereço. Não somos nós que enviamos a sua newsletter: envia-a a partir do serviço de e-mail que usar.

Para que estes e-mails não acabem no spam, um endereço cujo e-mail é devolvido, ou que marca um deles como spam, nunca recebe outro, de nenhum site. Se várias pessoas marcarem as confirmações de um site como spam, suspendemos as inscrições dele e enviamos-lhe um e-mail. Normalmente isso significa que um robô está a escrever endereços.

Ser avisado no momento em que chega uma.