API InformeLegal

• InformeLegal no envía ninguna comunicación.
• No se valida remitente, canal ni contenido: se acepta cualquier canal (email, sms, whatsapp, postal, phone, other).
• La comunicación se guarda directamente en estado sent junto con su log de trazabilidad.
• El objeto externalLog queda disponible en el detalle y el listado de comunicaciones (API y portal).

curl -X POST https://informelegal.org/api/public/v1/cases/AR-2026-00001234/communications \
  -H "Authorization: Bearer $ILK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "external": true,
    "channel": "whatsapp",
    "subject": "Intimación de pago",
    "contentText": "Notificación enviada desde el CRM propio.",
    "recipients": [{ "destination": "+5491122334455", "recipientType": "to", "role": "TITULAR" }],
    "externalReference": "CRM-2026-0007",
    "externalLog": {
      "system": "CRM Propio",
      "providerName": "Twilio",
      "providerMessageId": "SM1234567890",
      "status": "delivered",
      "sentAt": "2026-08-18T14:05:00Z",
      "deliveredAt": "2026-08-18T14:05:12Z",
      "operator": "mlopez",
      "cost": 0.04,
      "currency": "USD",
      "evidenceUrl": "https://crm.example.com/evidencias/SM1234567890.pdf"
    }
  }'

• Identificá cada destinatario por recipientId, destination o externalId.
• Los eventos quedan auditados en el historial del destinatario y en el log técnico de intentos de entrega.
• Si no enviás status, InformeLegal lo deriva (sent, partial o failed) y recalcula los contadores.
• Se emite el webhook saliente correspondiente: communication.sent, communication.failed o communication.cancelled.

Normalización: accepted→sent; opened/clicked→read; bounced/rejected→failed; complained/unsubscribed→opted_out; deferred→sending.

curl -X POST https://informelegal.org/api/public/v1/cases/AR-2026-00001234/communications/{communicationId}/status \
  -H "Authorization: Bearer $ILK_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "externalLog": { "providerName": "Twilio", "system": "CRM Propio" },
    "events": [
      { "destination": "+5491122334455", "event": "delivered", "occurredAt": "2026-08-21T13:05:00Z", "providerMessageId": "SM1234567890" },
      { "destination": "deudor@example.com", "event": "bounced", "errorCode": "550", "errorMessage": "mailbox not found" }
    ]
  }'

• En la URL, USER_ID acepta tanto el UUID del usuario como su email (por ejemplo usuario@empresa.com).
• Solo se resuelven usuarios que pertenecen a la organización de la API Key; en caso contrario se devuelve 403 AUTOLOGIN_USER_NOT_ALLOWED o 404 AUTOLOGIN_USER_NOT_FOUND.
• El token es una credencial: tratalo como un secreto, no lo registres en logs ni lo envíes por canales inseguros.
• El valor completo se devuelve solo al crearlo; la base conserva únicamente su hash.
• Es de un solo uso y se invalida en el momento del canje.
• Vigencia mínima 60s, por defecto 600s y máximo 3600s (1 hora).
• Portales permitidos: user_portal, company_portal, legal_firm_portal. El portal administrador no está habilitado.
• redirect_path debe ser una ruta interna relativa dentro de la allowlist de la API Key (sin dominios externos ni ..).
• Con invalidate_previous: true (default) los tokens activos previos del mismo usuario y portal quedan como replaced.
• La sesión creada usa exclusivamente los roles y permisos actuales del usuario: nunca hereda permisos de la API Key.
• Se aplica idempotencia por Idempotency-Key y límites de emisión por API Key (respuesta 429).
• Endpoints complementarios: consulta de estado, revocación de un token y revoke-all.

curl --request POST \
  --url https://www.informelegal.org/api/public/v1/users/USER_ID/autologin \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: autologin-user-123-001' \
  --data '{
    "portal": "user_portal",
    "expires_in_seconds": 600,
    "redirect_path": "/expedientes",
    "invalidate_previous": true,
    "external_reference": "CRM-LOGIN-001"
  }'

• Se configuran en el portal, en Variables personalizadas, indicando entidad, código, etiqueta y tipo (texto, texto largo, número, fecha, sí/no o lista de opciones).
• Se envían y se devuelven en el objeto opcional customFields, donde cada clave es el código de la variable.
• Disponibles en expedientes (POST/GET /v1/cases), partes, movimientos y comunicaciones.
• Todas son opcionales. Un código inexistente devuelve 422 UNKNOWN_CUSTOM_FIELD y un valor con tipo inválido 422 INVALID_CUSTOM_FIELD.

"customFields": { "asignacion": "Equipo Recupero A", "importancia": "Alta" }