Referencia (endpoints)Alertas

Prender o apagar una alerta en un destino

Sirve para elegir qué alertas recibe cada destino verificado, prendiéndolas o apagándolas una por una, por ejemplo la desconexión de un número o un pago fallido.

PUT
/alerts/destinations/{id}/settings

Escritura · requiere Números de WhatsApp → Editar.

module y action son los de una alerta del catálogo (GET alerts/catalog); enabled la activa o la apaga. Un destino phone tiene que estar verificado.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

id*string

Id opaco: un texto que empieza con ald_. Se usa tal como llega; no se arma ni se interpreta.

Patrón^ald_[A-Za-z0-9]{23}$

Cuerpo del pedido

application/json
  1. body
module*AlertModule
Valor en"device""mac""billing""subscription""account""campaign""group""broadcast""ai_quota"
action*AlertAction
Valor en"disconnected""usage_80""expiring""usage_100""upcoming_charge""payment_failed""plan_blocked""reactivated""trial_ending""cancellation_confirmed""dormant_ending""blocked""no_groups_available""daily_report""action_failed""message_failed""full""invalid_link""started""paused""resumed""cancelled""finished""summary""low_balance""topup_succeeded""topup_failed"
enabled*boolean

Cuerpo de la respuesta

La alerta del destino, con su estado.

application/json
  1. response
module*string
action*string
enabled*boolean
curl -X PUT "https://example.com/alerts/destinations/ald_Atlwq6tfM6G0SC3Hu6slnUc/settings" \  -H "Content-Type: application/json" \  -d '{    "module": "device",    "action": "disconnected",    "enabled": true  }'
{  "module": "string",  "action": "string",  "enabled": true}

Esto es lo que se copia para tu IA

Cargando…