Integración con Tilda
Generación automática de archivos mediante un formulario en tu sitio de Tilda. Los visitantes podrán ingresar su Nombre y otros datos para recibir un archivo listo. Si es necesario, el archivo podrá enviarse por correo electrónico al destinatario.
Creación de un formulario en Tilda
Para enviar solicitudes de creación de archivos, es necesario crear un formulario en el sitio. Este formulario puede estar ubicado tanto en el Panel de Usuario como en la parte pública del sitio. Puedes agregar cualquier formulario disponible en el catálogo de bloques de Tilda.
Configuración del formulario
Presiona el botón "Contenido" en la esquina izquierda del formulario. Luego, haz doble clic en el encabezado "Recepción de datos del formulario". Aparecerá
un interruptor adicional "Script personalizado para la recepción de datos",
el cual debes seleccionar. En el campo de entrada, ingresa la siguiente dirección:
https://dimaker.app/api/v1/tilda-create/
Ventana de configuración del formulario - recepción de datos
Es importante que la transmisión de datos se realice sin recargar la página (AJAX).
Campos de entrada
En el documento DiMaker, debe haber al menos una variable para sustituir, por ejemplo, %name o %course. La variable debe ser escrita en caracteres latinos. No se permiten caracteres cirílicos como %фио o %класс. La dirección de correo electrónico es %email.
En el contenido del formulario, en Tilda, debes añadir un "Campo en una línea" (como "Nombre" o "Correo electrónico"). En el campo "Título del campo", escribe qué datos deben introducirse, como "Nombre completo". En el campo "nombre de la variable", usa el nombre de la variable sin el símbolo % del documento, pero con el prefijo mask_. Por ejemplo, si en el documento aparece %name, el nombre de la variable en Tilda será mask_name; si en el documento aparece %course, el nombre será mask_course. Los datos que el visitante introduzca en estos campos se sustituirán por las variables correspondientes en el texto del documento.
Adición del campo mask_name, correspondiente a %name en el documento
Si necesitas enviar el archivo generado por correo electrónico y el formulario está disponible públicamente (no en el Panel de Usuario), deberás añadir un campo para el E-mail. En este caso, el nombre de la variable será "mask_email".
Adición del campo mask_email, correspondiente a %email en el documento
Puedes usar cualquier cantidad de campos de entrada y variables en el documento. Los datos proporcionados por el visitante se usarán para personalizar el archivo.
Si necesitas incluir la fecha actual, un número aleatorio u otros datos, puedes usar funciones.
Campos ocultos del formulario
A continuación, es necesario crear varios campos ocultos. Estos aseguran la identificación del formulario, indican qué documento usar, en qué carpeta del Disco guardar el archivo, entre otros.
El formulario debe incluir al menos dos campos obligatorios y, si lo deseas, algunos opcionales.
Los campos obligatorios están marcados con un asterisco.
secure *
Token de acceso. Obtén este token en la integración necesaria con Tilda, en el campo "Token".
-
doc_id *
Obtén el ID del documento desde la barra de direcciones cuando el documento esté abierto. El ID tiene 36 caracteres, sin barras. El documento no debe estar en la papelera, pero puede estar en cualquier carpeta en Documentos.
-
mail_id
El ID de la plantilla de correo debe obtenerse desde la barra de direcciones cuando la plantilla esté abierta. El ID tiene 36 caracteres, sin barras. Si la variable no es proporcionada, no se enviará ningún correo.
-
email_send
Hora para enviar el correo con el archivo. Puede tomar los siguientes valores:
onfinish - Enviar todos los correos después de crear todos los archivos en el grupo (valor predeterminado)
oncreate - Enviar correos inmediatamente después de crear el archivo. Si se crea un solo archivo, onfinish y oncreate son idénticos.
timeout - Enviar correos después de un intervalo de tiempo. En este caso, se deben proporcionar dos parámetros adicionales:
email_timeout_value - valor numérico del intervalo (número entero)
email_timeout_measure - unidad del intervalo: "m" (minutos), "h" (horas), "d" (días).Alternativamente, especifica un tiempo exacto usando el formato UNIX timestamp en email_timeout_timestamp. Si se proporcionan ambos parámetros, prevalecerá este último. -
folder_id
Carpeta donde se guardarán los archivos en el Disco. Si la carpeta no existe, se creará automáticamente la primera vez que se guarde un archivo. Obtén el ID desde la barra de direcciones al abrir la carpeta. El ID tiene 36 caracteres, sin barras.
-
page_id
Si el documento tiene varias páginas, usa el campo page_id para especificar el número de página (comenzando desde 0) o los números de las páginas que se deben incluir, separados por comas.
Por lo tanto, el formulario debe incluir al menos dos campos obligatorios: el campo Secure.
Campo oculto Secure. El valor del campo debe obtenerse en la configuración.
Y el campo doc_id.
Campo oculto doc_id. Valor del campo: ID del documento desde la barra de direcciones.
Además, si es necesario enviar el archivo por correo electrónico, se debe especificar el ID del correo.
Campo oculto mail_id. Valor del campo: ID del documento desde la barra de direcciones.
Para añadir el archivo a una carpeta específica en el Disco, especifica el ID de la carpeta.
Campo oculto folder_id. Valor del campo: ID de la carpeta desde la barra de direcciones.
La traducción es extensa. Avisame si progresamos traducción de las secciones restantes.