Enviar recordatorios

Cuando un firmante no ha completado su firma, puedes reenviar la invitación por correo electrónico o SMS para recordarle que tiene un documento pendiente. Este tutorial explica cómo enviar recordatorios utilizando la API de Signatura.

Requisitos previos

Para reenviar una invitación necesitas:

• Una API key válida
• El ID de la firma (signature_id) pendiente
• La firma debe estar en estado Inicial (IN) o Leído (PE)
• El documento no debe estar en estado Borrador
• Haber esperado al menos 2 horas desde el último envío

Endpoint

POST /api/v2/signatures/{id}/resend-invitation
Authorization: Bearer <apikey>

El parámetro {id} corresponde al UUID de la firma a la que deseas reenviar la invitación.

Ejemplo de solicitud

curl -X POST "https://connect.signatura.co/api/v2/signatures/f5407940-6d19-4508-baed-195c03fcf739/resend-invitation" \
  -H "Authorization: Bearer <apikey>"

Ejemplo de respuesta exitosa

Una respuesta exitosa devuelve un código 200 sin contenido en el cuerpo.

HTTP/1.1 200 OK

Códigos de respuesta

Código	Descripción
200	Invitación reenviada correctamente
400	No se puede reenviar: el documento es un borrador, la firma ya está completada/cancelada, o la firma no tiene una invitación configurada
404	La firma no existe o no soporta reenvío de invitación
429	Ya se envió una invitación en las últimas 2 horas

Canal de envío

El recordatorio se enviará por el mismo canal configurado originalmente para la firma:

• Email (EM): Se envía un correo electrónico al firmante
• SMS (PH): Se envía un mensaje de texto al número de teléfono del firmante

El canal utilizado depende del valor de invite_channel configurado al crear el documento.

Estados de firma

Código	Estado	¿Se puede reenviar?
IN	Inicial (no ha abierto la invitación)	Sí
PE	Leído (abrió pero no firmó)	Sí
CO	Completado	No
CA	Cancelado	No
DE	Rechazado	No

Límite de frecuencia

Para evitar el envío excesivo de mensajes, Signatura aplica un límite de una invitación cada 2 horas por firma. Si intentas reenviar antes de que transcurra este tiempo, recibirás un error 429.

Cómo obtener el ID de la firma

Puedes obtener los IDs de las firmas pendientes consultando los detalles del documento:

curl -X GET "https://connect.signatura.co/api/v2/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer <apikey>"

La respuesta incluye un array signatures con todas las firmas y sus estados:

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "title": "Contrato de servicios",
  "status": "PE",
  "signatures": [
    {
      "id": "f5407940-6d19-4508-baed-195c03fcf739",
      "status": "IN",
      "invite_channel": ["EM"],
      "url": "https://connect.signatura.co/s/abc123"
    },
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "status": "CO",
      "invite_channel": ["PH"],
      "url": "https://connect.signatura.co/s/xyz789"
    }
  ]
}

En este ejemplo, solo la primera firma (con status IN) puede recibir un recordatorio.

Buenas prácticas

• No abuses de los recordatorios: Enviar demasiados mensajes puede molestar a los firmantes y reducir la tasa de conversión.
• Espera un tiempo razonable: Considera esperar al menos 24-48 horas antes de enviar el primer recordatorio.
• Usa webhooks: En lugar de consultar periódicamente el estado de las firmas, configura webhooks para recibir notificaciones cuando se complete una firma.