​

Opt-out y listas de supresión

​

Cómo se produce la supresión

• Un contacto responde con una palabra clave STOP en SMS/WhatsApp.
• Un contacto se da de baja a través del Centro de preferencias.
• Usted registra una baja a través de la API de consentimiento (opt_in: false).
• Usted importa masivamente una lista (esta página).

• La importación masiva de CSV infiere el ámbito a partir del tipo de dirección de cada fila: las direcciones de teléfono y de WhatsApp tienen por defecto el ámbito all — una señal de STOP en un número de teléfono suprime todos los canales alcanzables en ese número — mientras que las direcciones de correo electrónico se limitan al ámbito email. Una columna channel sobrescribe esto por fila (consulte Importación masiva de CSV).
• La API de consentimiento y el Centro de preferencias siempre suprimen con el ámbito all, independientemente de si el identificador registrado es un número de teléfono o una dirección de correo electrónico. Una baja a través de cualquiera de estos puntos de entrada elimina al contacto de todos los canales.

​

Importación masiva de CSV

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/suppression-list/import \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -F "file=@suppressions.csv" \
  -F "default_country=US" \
  -F "default_reason=migrated_from_legacy_platform" \
  -F "dry_run=false"

​

Campos del formulario

​

Formato del CSV

phone,email,reason
+14155550101,,replied STOP
,jordan@example.com,unsubscribed via email
+442071838750,sam@example.co.uk,complaint

​

Resultados por fila

{
  "data": {
    "run_id": "supimp_4d…",
    "total_rows": 1000,
    "accepted": 950,
    "duplicates": 30,
    "intra_file_duplicates": 15,
    "invalid": 5,
    "errors": [
      { "status": "invalid", "reason": "invalid_phone", "raw_line": 42 }
    ],
    "by_channel": { "all": 800, "email": 150 },
    "file_sha256": "9b2e…"
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

​

Motivos de validación

​

Límites

​

Cuando falla una importación

​

Importar desde el panel

1. Elegir archivo CSV: elija un .csv de menos de 25 MB. Use Download sample CSV en el diálogo para obtener un archivo inicial preformateado.
2. Establecer valores por defecto (opcional): un Default country (ISO alpha-2) para normalizar números en formato nacional y un Reason de texto libre estampado en cada fila aceptada.
3. Previsualizar: ejecuta la importación como una ejecución de prueba en el servidor: no se escribe nada y el diálogo muestra el desglose de aceptadas / ya en la lista / repetidas en el archivo / inválidas antes de que confirme.
4. Confirmar importación: realiza la escritura que confirma. Si alguna fila fue inválida, descargue skipped.csv para corregirlas y reimportarlas.

​

Exportar la lista de supresión

curl "https://api.orbit.devotel.io/api/v1/compliance/suppression-list/export?format=csv&status=active" \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -o suppression-list.csv

​

Verificar que una supresión surtió efecto

1. Envíe un mensaje de prueba a la dirección suprimida. Un envío directo por API a un destinatario suprimido falla de forma síncrona con HTTP 422 y el código de error RECIPIENT_OPTED_OUT. En modo sandbox no se toca ningún operador y no se deduce saldo; cualquier destinatario que termine en 8 además se resuelve al recibo de entrega simulado blocked, que es la visión del operador de la misma barrera.
   curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
     -H "X-API-Key: $ORBIT_SANDBOX_KEY" \
     -H "Content-Type: application/json" \
     -d '{"to": "+14155550101", "from": "+15005550101", "body": "gate check"}'
   
   {
     "error": {
       "code": "RECIPIENT_OPTED_OUT",
       "message": "Recipient has opted out of this channel"
     }
   }
   
   Un envío de campaña a la misma dirección se comporta de forma diferente por diseño: el destinatario se omite silenciosamente (status: "skipped", reason: "opted_out") para que el lote siga avanzando: consulte el informe por destinatario de la campaña en lugar de esperar un error.
2. Confirme que la entrada está en el registro. Exporte con la consulta anterior (status=active es el valor por defecto) y compruebe que la dirección aparece con el ámbito channel esperado. La exportación es la fuente de verdad que lee cada puerta de envío: si la fila está active ahí, la barrera está levantada.

​

Eliminar una supresión (nueva suscripción)

​

Referencias relacionadas

• Gestión del consentimiento: registre y consulte el consentimiento por canal.
• Puertas de envío: horas de silencio, DNC, RND, RMD, parada de emergencia y el centro de preferencias.
• DSAR: cómo las solicitudes delete / opt_out llegan a la supresión.
• Referencia de API → Opt-outs: esquemas de los endpoints de baja y supresión.