Integración con GetCourse

Creación y envío automático de diplomas y certificados desde GetCourse tras la finalización de un curso o webinar. El enlace al diploma generado se guardará en los datos del alumno en GetCourse.

Creación del proceso

Para enviar solicitudes de creación de archivos a DiMaker, es necesario configurar un proceso en GetCourse. Para hacerlo, accede a "Tareas" - "Procesos". Luego selecciona "Crear proceso". Rellena el nombre y elige "Tipo de objeto" - "Usuarios".

Ventana de configuración del proceso

Posteriormente, en el proceso, selecciona la pestaña "Proceso" y, en la parte derecha, haz clic en "Añadir bloque" - "Operación".

Ventana de configuración del proceso - añadir llamada de URL

En la ventana que aparece, selecciona "Llamar URL" (es el último elemento) y haz clic en "Guardar".

Ventana de configuración de la operación en el proceso

Este es el panel principal. Debes seleccionar el método POST, y en el campo URL ingresar la cadena de solicitud que incluirá:

• Dirección de solicitud - https://dimaker.app/api/v1/create/?
• Token API - secure (obtenlo en la sección de configuración de DiMaker)
• ID del documento - doc_id El documento a partir del cual se generará el certificado o diploma
• ID de la carpeta - folder_id Carpeta en el Disco donde se guardará el archivo
• ID de la plantilla de correo - mail_id Plantilla del mensaje que se usará para enviar el archivo
• Datos a reemplazar, cada variable que comienza con mask_

Primero explicamos en detalle cada uno de estos datos, luego veremos cómo debería ser en conjunto la cadena de solicitud final.

Variables

La solicitud debe contener variables que aseguren el acceso a la cuenta en DiMaker, indiquen qué documento utilizar, en qué carpeta del Disco guardar el archivo, etc.

Las variables marcadas con un asterisco (*) son obligatorias.

• secure*

  Token (cadena de 36 caracteres) de la sección "Tokens API" en DiMaker

• doc_id*

  ID del documento (cadena de 36 caracteres) que se utilizará para la creación del archivo. El ID se puede obtener en la barra de direcciones al abrir el documento. El documento no debe estar en la papelera, pero puede estar en cualquier carpeta de Documentos.

• mail_id

  ID de la plantilla de correo (cadena de 36 caracteres) para enviar por correo electrónico. El ID se puede obtener en la barra de direcciones al abrir la plantilla. Si no se pasa esta variable, el correo no será enviado.

• email_send

  Define el momento en el que se enviará el correo con el archivo. Puede tomar los siguientes valores:
  onfinish - Enviar todos los correos una vez creados todos los archivos (por defecto)
  oncreate - Enviar correos inmediatamente tras la creación del archivo. Si se genera un solo archivo, onfinish y oncreate son equivalentes.
  timeout - Enviar correos tras un intervalo de tiempo. En este caso, también se deben incluir los parámetros:
  email_timeout_value - valor numérico del intervalo (entero)
  email_timeout_value - unidad del intervalo. Puede ser "m" (minutos), "h" (horas) o "d" (días).
  Para un envío en una fecha y hora específica, utiliza email_timeout_timestamp en formato unix time. Si se define timeout y email_timeout_timestamp, se prioriza este último.

• folder_id

  ID de la carpeta en el Disco (cadena de 36 caracteres) donde se guardarán los archivos. Si la carpeta no existe, se creará automáticamente al generar el primer archivo.

• page_id

  Número de hoja (número o cadena) si el documento tiene varias hojas. Puedes incluir un solo número (la primera hoja es 0) o varios números separados por comas.

• result

  Define cómo se devolverá el resultado. Puede tener los siguientes valores:

  • Sin valor. Se devolverá una cadena con el resultado de la solicitud.
  • link. Si la solicitud es exitosa, se devolverá un enlace al archivo creado (si se generaron varios archivos, el enlace será al primero). Puedes descargar el archivo accediendo al enlace. El tiempo de creación del archivo es de 1 a 5 segundos por archivo; antes de que esté listo, el enlace retornará error 404.
  • file. Si la solicitud es exitosa, el archivo generado será descargado directamente (solo el primero si se generaron varios). Si no se completa en 30 segundos, se devuelve error 404.

Variables en Documentos

En los documentos de DiMaker debe haber al menos una variable de reemplazo, por ejemplo, %name o %city. Las variables deben estar escritas en letras latinas; no se permite el uso de caracteres cirílicos como %nombre.

Al construir la URL en los procesos, el nombre de la variable debe comenzar con mask_, seguido del nombre de la variable en el documento. Por ejemplo, si en el documento la variable es %name, su representación en la URL será mask_name. Los datos para estas variables serán enviados al Documento en DiMaker al crear el archivo.

Otras integraciones