Skip to main content
Del registro en la lista al primer bloqueo en pocos pasos. La API Key necesita los alcances suppressions:read y suppressions:write.

​
En resumen

  • Agregue email, teléfono, Telegram o Instagram a la lista global de no contactar.
  • Consulte entradas con filtros por tipo, motivo y búsqueda.
  • Elimine por ID o por identidad cuando el cliente vuelva a aceptar mensajes.
Contexto: Introducción. Alcances: Alcances de API Key.

​
Antes de empezar

Base URL: https://api.notifique.dev.

​
1. Agregar a la lista

El teléfono bloquea SMS, WhatsApp, RCS y voz de una vez — como poner el número en el cuaderno de la portería.
Respuesta esperada: 201 (entrada nueva) o 200 (ya existía, idempotente). La API normaliza el teléfono a E.164 antes de guardar.
La inclusión es idempotente: si la identidad ya está activa, la API devuelve la entrada existente sin duplicar.

​
Email, Telegram o Instagram

Detalles de formato: Normalización por tipo.

​
2. Listar y consultar

Listar con filtros opcionales:
Parámetros útiles: type, reason, origin, channel, search. Consultar una entrada por el ID devuelto en el POST:

​
3. Eliminar de la lista

Por ID:
Por identidad (sin necesitar el ID):
Eliminar reactiva el envío de inmediato. Si la dirección vuelve a generar bounce, complaint o STOP, puede suprimirse de nuevo automáticamente.

​
4. Importar en lote

En la API, envíe hasta 100 ítems por llamada:
Cada ítem devuelve estado individual: agregada, ya existente o inválida. En el panel (Audiencia → Supresiones), importe CSV/XLSX con cabeceras type,value,reason — hasta 1.000 filas, en lotes de 100. La columna channel en el CSV es contexto de importación en el panel; en la API v1 el bloqueo sigue el type (teléfono bloquea sms/whatsapp/rcs/voice). Para eliminar en lote: POST /v1/suppressions/batch/remove con ids y/o identities.

​
Próximos pasos