Integração com a Tilda

Criação automática de arquivos através de formulários no seu site na Tilda. Os visitantes do seu site poderão inserir seus Nomes e outras informações pessoais para gerar um arquivo pronto. Se necessário, o arquivo pode ser enviado diretamente para o e-mail do destinatário.

Criação do formulário na Tilda

Para enviar as solicitações de criação de arquivos, é necessário criar um formulário no site. Esse formulário pode estar no Painel de Controle ou na página pública do site. É possível adicionar qualquer formulário disponível no catálogo de blocos da Tilda.

Configurações do formulário

Você deve clicar no botão "Conteúdo" no canto esquerdo do formulário. Em seguida, dê dois cliques no cabeçalho "Recepção de dados do formulário". Um botão adicional chamado "Script personalizado para recepção de dados" aparecerá, e ele deve ser ativado. No campo de entrada, insira o seguinte endereço:
https://dimaker.app/api/v1/tilda-create/

Janela de configuração do formulário - recepção de dados

Certifique-se que sua configuração permite o envio de dados sem recarregar a página (usando AJAX).

Campos para preenchimento

No documento do DiMaker, deve haver pelo menos uma variável a ser substituída, como %name ou %course. As variáveis devem ser escritas em caracteres latinos. Variáveis com caracteres cirílicos como %фио ou %класс não são permitidas. O endereço de e-mail utiliza %email.

No conteúdo do formulário na Tilda, adicione um "Campo de linha única" (ou, por exemplo, "Nome", "Email"). No campo "Título do Campo", insira os dados que serão solicitados, como "Nome e Sobrenome Completo". No campo "Nome da Variável", insira o nome da variável sem o símbolo % do documento, antecedido pelo prefixo mask_. Por exemplo, se o documento usar %name, o nome da variável na Tilda será mask_name. Se a variável no documento for %course, o nome será mask_course. Os dados inseridos pelos visitantes nesses campos serão substituídos pelas respectivas variáveis no texto do documento.

Adicionando o campo mask_name, que corresponde a %name no documento

Se for necessário enviar o arquivo pronto por e-mail e o formulário estiver em uma página pública (não no Painel de Controle), é necessário adicionar um campo para a inserção do endereço de e-mail. Nesse caso, o nome da variável será "mask_email".

Adicionando o campo mask_email, que corresponde a %email no documento

Podem haver quantos campos forem necessários, permitindo solicitar dados aos visitantes para inseri-los no arquivo final.

Se for necessário inserir a data atual, um número aleatório ou outros dados, utilize as funções.

Campos ocultos do formulário

Além disso, devem ser criados alguns campos ocultos. Eles identificam o formulário, especificam qual documento usar, em qual pasta salvar o arquivo no Drive, e outras configurações.

O formulário deve conter pelo menos dois campos obrigatórios e, se necessário, outros opcionais.

Os campos obrigatórios são marcados com um asterisco.

• secure *

  Token de acesso. Este token pode ser encontrado na seção de integração necessária com a Tilda.

• doc_id *

  ID do documento. Este ID está na barra de endereços ao abrir o documento. Ele possui 36 caracteres e não contém barras. O documento não deve estar na lixeira, mas pode estar em qualquer pasta nos Documentos.

• mail_id

  ID do modelo de e-mail. Este ID pode ser encontrado na barra de endereços quando o modelo de e-mail está aberto. Possui 36 caracteres e não contém barras. Se a variável não for enviada, o e-mail não será enviado.

• email_send

  Momento em que o e-mail com o arquivo será enviado. Pode assumir os seguintes valores:
  onfinish - Enviar os e-mails após a criação de todos os arquivos em um grupo (padrão).
  oncreate - Enviar o e-mail imediatamente após a criação do arquivo.
  timeout - Enviar o e-mail após um intervalo de tempo. Neste caso, os seguintes dois parâmetros devem ser informados:
  

  email_timeout_value - valor numérico do intervalo de tempo (valor inteiro).
  email_timeout_unit - unidade de tempo. Pode ser "m" (minutos), "h" (horas) ou "d" (dias).
  Para especificar um horário exato para o envio, forneça um timestamp em Unix no campo email_timeout_timestamp. Se ambos os valores forem enviados, o último terá prioridade.

• folder_id

  Pasta para salvar os arquivos no Drive. Se a pasta não existir, ela será criada automaticamente ao gerar o primeiro arquivo. O ID da pasta está disponível na barra de endereços quando a pasta é aberta. ID com 36 caracteres, sem barras.

• page_id

  Se o documento possui várias páginas, o campo page_id pode conter o número da página (iniciando em 0) ou os números separados por vírgula das páginas que devem ser usadas na criação do arquivo.

Portanto, o formulário deve conter pelo menos dois campos ocultos obrigatórios: o campo Secure e o campo doc_id.

Campo oculto Secure. O valor desse campo deve ser obtido nas configurações.

Além disso, se necessário enviar o arquivo por e-mail, é preciso indicar o ID do e-mail.

Por conta do limite de caracteres, o texto não pôde ser traduzido por completo. Se precisar continuar a tradução ou tiver dúvidas, me avise!

---

Outras integrações