Saltar al contenido principal

Datos de contexto en restricciones

Datos de contexto en restricciones

Al aplicar o levantar una restricción, deja contexto con estos campos libres: origin_event, origin, metadata y reason_code. Todos quedan dentro de la evidencia de la acción, que Soyio sella y encadena para que no se pueda alterar.

No incluyas datos personales

Como la evidencia está sellada, lo que pongas en estos campos no se puede borrar después, ni siquiera si la persona pide que se eliminen sus datos. No incluyas nombres, correos, teléfonos, RUT ni nada que identifique a la persona. Usa identificadores internos de tu sistema.

origin_event: para cruzar con tus registros​

Identifica la solicitud en el sistema donde se originó. Úsalo para encontrar la acción desde tus propios registros, y para que un reintento no cree una acción duplicada.

  • system: el sistema que registró la solicitud, por ejemplo call_center o crm
  • event_id: el identificador de la solicitud en ese sistema, por ejemplo el número de ticket
  • occurred_at (opcional): cuándo ocurrió la solicitud en tu sistema
{
  "origin_event": {
    "system": "call_center",
    "event_id": "CL-9931",
    "occurred_at": "2026-09-29T12:58:00Z"
  }
}

origin_event no es un lugar para guardar datos de la persona: el número de ticket basta para llegar a ellos desde tu sistema.

origin: desde dónde llegó​

Un texto corto que describe el punto de contacto, por ejemplo call center, sucursal Providencia o formulario de desuscripción.

metadata: datos propios de tu integración​

Un objeto JSON de hasta 4 KB para lo que necesites asociar a la acción:

{
  "metadata": {
    "campaign_id": "campaign_abc123",
    "agent_id": "agent_042",
    "form_version": "v3"
  }
}

Casos de uso comunes:

  • Identificadores internos del agente o del flujo que registró la solicitud
  • Versión del formulario o del guion de atención
  • Identificador de la campaña que motivó la solicitud

Motivo de la solicitud​

Hay dos campos para el motivo. Los dos son opcionales y de texto libre: Soyio no valida sus valores.

  • reason_code: un código corto que defines tú, como sernac o unsubscribe. Sirve para agrupar y filtrar las restricciones por motivo. Queda en la evidencia sellada y se copia a cada restricción del agreement, así que aparece también cuando consultas el estado o las restricciones de una persona. No incluyas datos personales.
  • reason_text: una explicación del caso en tus palabras. Queda guardado en la acción y lo ves al consultarla, pero no forma parte de la evidencia ni de las restricciones del agreement.

Usa siempre los mismos códigos en reason_code y deja los detalles para reason_text. Si escribes una explicación en reason_code, queda sellada y se repite en cada consulta.

Próximos pasos​