Coletar respostas

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

O formulário

Envie para /_solta/forms/ seguido de um nome que você escolher, no endereço próprio do seu site. Use um nome fixo no código, para o Solta conseguir encontrá-lo. Quando o site é salvo, o Solta encontra o formulário, e ele já começa a receber: as respostas chegam na aba Respostas do site. Configurações do site → Formulários lista todos os formulários para onde o código envia, cada um com uma chave para desligá-lo, e com Me mandar cada resposta por e-mail, se você quiser receber as respostas assim que chegam. Um formulário que você desliga continua desligado. Um site publicado sem conta não guarda nada até alguém entrar para ficar com ele, porque ninguém ainda 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 comum, e funciona: o visitante vê uma página curta dizendo que a resposta foi enviada, ou por que não foi. Se preferir enviar JSON, envie JSON para o mesmo endereço: cada campo vira uma coluna.

O que a página deve dizer depois

Diga à pessoa, com clareza, o que aconteceu. Um retorno 2xx quer dizer que a resposta foi guardada: diga que foi enviada e quem vai vê-la. Quando não foi, o JSON diz o motivo, e a página pode guardar a resposta no dispositivo do visitante e dizer qual foi:

• 409 com not_collecting: esta página não está recebendo respostas agora (o formulário está desligado, ou ainda ninguém entrou 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 retorno, porque o pedido falhou: não há conexão.
• Qualquer outra coisa: mostre o error do JSON e deixe a pessoa tentar de novo.

Por que o seu próprio endereço

A ação é um caminho, e não uma URL em outro lugar. Isso é de propósito: um formulário que envia para outra origem faz um pedido entre origens diferentes, que o navegador bloqueia ou obriga você a contornar, e um site no Solta não tem um servidor seu para fazer isso. O seu site envia para o seu site.

Como ler as respostas

Abra o site e há uma aba Respostas ao lado de Comentários e Versões, com as mais novas primeiro e um botão CSV que baixa as respostas como planilha. Só você vê essa aba. Nos planos Free e Plus, você 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 ela diz: as primeiras 5 de cada hora uma por uma, e o resto daquela hora junto, na hora cheia. Desligue Me mandar cada resposta por e-mail num formulário, e as respostas dele vão para o e-mail diário. Todos esses e-mails têm Parar estes e-mails para este site no rodapé, e Configuraçõ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 com =, +, - ou @ é uma fórmula para uma planilha, e as respostas vêm de desconhecidos. Colocamos um caractere na frente desses valores, para o texto continuar legível e a fórmula não ser executada.

Os limites

Os formulários de uma conta recebem 100 respostas por mês no Free e 500 no Plus, somando todos os sites dela. Nos planos Free e Plus, as respostas ficam guardadas por 30 dias, e você recebe um e-mail por dia com o que chegou. Os formulários desses planos não podem receber senhas, números de cartão nem códigos. Passando das respostas do mês, até mais 100 são guardadas do mesmo jeito, bloqueadas: a aba Respostas e o e-mail diário dizem quantas são, e elas podem ser lidas nos planos Pro e Team. O Pro recebe 1.000 por mês, e o Team 10.000. Os dois mandam cada uma por e-mail, a não ser que você desligue isso, e guardam as respostas pelo tempo que você escolher. Além disso: 60 campos, 8 KB por campo e 60 respostas por hora vindas 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 por um ano por padrão, e depois são excluídas. Você escolhe, para cada formulário, na aba Respostas: 30 dias, um ano, ou até você excluí-las. Elas são suas, e você pode exportá-las quando quiser.

Slack e Planilhas Google

No Pro e no Team, Configurações do site → Formulários também pode mandar cada resposta para um canal do Slack ou para uma Planilha Google, com tudo o que ela diz, de todos os formulários daquele site. Quem pode ler o canal ou a planilha pode ler o que as pessoas digitaram, então escolha um que seja seu para compartilhar. Cada um é testado quando você conecta, e as configurações dizem quando chegou a última resposta, ou por que ela não chegou.

Slack: cole uma URL de incoming webhook (no Slack, Apps → Incoming Webhooks → Add to Slack), ou escolha um canal que você já conectou em Configurações → Chaves e conexões. Antes, o Solta publica uma linha lá, para confirmar que ela chega.

Planilhas Google: um pequeno script que você adiciona à planilha recebe as linhas. Assim, o Solta nunca entra na sua conta Google nem vê mais nada no seu Drive.

1. Em Configurações do site → Formulários, escolha Planilha Google e copie o script. Ele leva o segredo desta conexão.
2. Abra a planilha e depois Extensões → Apps Script. Substitua o que estiver lá pelo script e salve.
3. Implantar (Deploy) → Nova implantação (New deployment). Tipo: App da Web. Executar como: Eu. Quem pode acessar: Qualquer pessoa. Autorize quando o Google pedir.
4. Cole no Solta o endereço do app da Web, terminado em /exec, e conecte.

O Solta confere se o script responde, sem escrever nenhuma linha. Depois, cada resposta adiciona uma linha numa aba com o nome do formulário, com uma coluna para cada campo, e vai assinada, para o script recusar qualquer coisa que não veio 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 mandar uma resposta automática curta, escrita por você, para quem o preenche, para a pessoa saber que chegou. Ela 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, 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. Nós adicionamos o nome e o endereço do site, e um jeito de a pessoa parar de receber essas mensagens ou denunciá-las. Nada do que ela digitou entra na mensagem. Quando alguém responde a essa mensagem, a resposta pode chegar ao seu e-mail, se você quiser.

Ela é enviada do endereço do Solta para e-mails disparados por visitantes, nunca em nome do site. Um site manda no máximo 50 por hora e 300 por dia, e um endereço cujo e-mail voltou, que marcou nossos e-mails como spam ou 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 pausadas e você é avisado.

Inscrições na newsletter

No Pro e no Team, um site pode ter uma lista de e-mails. Configurações do site → Newsletter configura tudo em três passos. Ligue Inscrições na newsletter. Adicione um formulário de inscrição, com Pedir para a sua IA adicionar (uma mensagem para colar no chat em que você cria o site) ou com o HTML. E confira se ele está lá: isso lê a versão no ar procurando um formulário que envia para /_solta/subscribe. Se a versão no ar tem um formulário assim enquanto as inscrições estão desligadas, a tela avisa, e o conector também avisa quando salva um. À mão, um formulário como este pode ficar em qualquer lugar 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 “confira seu e-mail”. Mandamos para cada endereço um link de confirmação, e só quem usa o link entra na lista. Assim, um endereço que outra pessoa digitou recebe um e-mail nosso uma vez, e nunca mais. O mesmo endereço inscrito duas vezes recebe um e-mail só.

Você pode baixar a lista como planilha (CSV), só com os endereços confirmados, cada um com o próprio link para cancelar a inscrição, para colocar no que você enviar. Usar esse link exclui o endereço. Nós não enviamos a sua newsletter: quem envia é você, pelo serviço de e-mail que você usa.

Para esses e-mails não caírem no spam, um endereço cujo e-mail volta, 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, pausamos as inscrições dele e mandamos um e-mail para você. Isso normalmente quer dizer que um robô está digitando endereços.

Ser avisado no momento em que uma chega.