Experiencias

Una Experiencia controla todo lo que el firmante ve y recibe cuando se le envía un documento: los correos electrónicos, la página de firma, la marca y el comportamiento. Cada grupo tiene al menos una Experiencia (la predeterminada), y puedes crear múltiples Experiencias para diferentes casos de uso.

Qué controla una Experiencia

Correos electrónicos

• Líneas de asunto para correos de invitación, recordatorio, finalización y rechazo
• Texto de encabezado y subencabezado del correo electrónico
• Texto adicional en el cuerpo del correo
• Logo del correo electrónico (subido por separado a través de la consulta upload)
• Si se adjunta un PDF borrador al correo de invitación

Página de firma

• Colores de la marca (fondo, bordes, botones, texto)
• Logo y dimensiones del logo
• Texto del encabezado y cuerpo mostrado al firmante
• Casillas de verificación del acuerdo (signingPageAgreeTicks) — exigir que el firmante acepte los términos antes de firmar
• Si el firmante puede rechazar el documento (signingPageRejectButton)
• Texto mostrado después de firmar (signingPageText)
• Tiempo de espera de la sesión (signingSessionTime)

Opciones de firma

• Métodos de entrada de firma: dibujar con el ratón (signatureMouse), escribir (signatureType), subir imagen (signatureUpload)
• Permitir reutilizar una firma anterior (allowSignatureReuse)
• Qué añadir a la firma: formato del nombre (signatureAppend), formato de fecha/IP (signatureAppendExtra)
• Diámetro del bolígrafo para firmas dibujadas
• Incluir un certificado digital (signatureCertificate)

Comportamiento

• emailSendSequence — enviar a todos los destinatarios a la vez (0) o en secuencia (1)
• canReassign — permitir que el firmante reasigne el documento a otra persona
• forwarding — permitir que el firmante reenvíe el documento
• postSignEmail — enviar un correo de confirmación tras firmar
• postSignAttach — adjuntar el PDF firmado al correo de confirmación
• Requisitos de testigos (witnessingRequiresSignerSMS, witnessingRequiresWitnessSMS)

Idioma

• language — código de idioma para la interfaz del firmante (ej. en, fr, de). Esto controla el idioma del texto generado por el sistema en la página de firma y en los correos.

Cuándo usar múltiples Experiencias

• Diferentes idiomas — crear una Experiencia por idioma para firmantes internacionales
• Diferente marca — personalizar la experiencia de firma para diferentes clientes o productos
• Diferentes reglas de firma — una Experiencia requiere casillas de acuerdo, otra no
• Interno vs externo — una Experiencia simplificada para personal interno, otra más formal para clientes externos

Uso de Experiencias con la API

Establecer la predeterminada

Una Experiencia por grupo se marca como defaultExperience: true. Los documentos enviados sin especificar una Experiencia usan esta.

Especificar al enviar

Pasa experience en cada destinatario en la mutación send para sobreescribir la predeterminada:

mutation {
  send(input: {
    groupId: "Z3JwMTIzNDU2"
    templateId: "dHBsMTIzNDU2"
    title: "Contract - French"
    recipients: [
      {
        firstName: "Marie"
        lastName: "Dupont"
        email: "marie@example.com"
        role: "Signer"
        experience: "ZXhwMTIzNDU2"
      }
    ]
  })
}

Operaciones CRUD

• createExperience — crear una nueva Experiencia en un grupo
• updateExperience — modificar una Experiencia existente
• deleteExperience — eliminar una Experiencia
• copyExperience — duplicar una Experiencia (opcionalmente a otro grupo)

Relacionado

• Referencia del tipo Experience — lista completa de campos
• Mutación send — pasar experience del destinatario al enviar
• Tipo Group — las Experiencias pertenecen a un grupo mediante experienceConnection