Referencia (endpoints)Números

Actualizar la salud de un número oficial

Sirve para pedirle a Meta la salud actualizada de un número; la respuesta indica si se refrescó de verdad o si devolvió el dato previo por la espera de 60 segundos u otra actualización en curso.

POST
/devices/{device}/health/refresh

Escritura · requiere Números de WhatsApp → Editar.

Le pide a Meta el estado actual del número y devuelve lo mismo que GET devices/{device}/health, más refresh_outcome:

  • refreshed: se consultó a Meta y respondió bien.
  • failed: se intentó consultar a Meta, pero falló (Meta rechazó la consulta o no respondió). stale es true; si Meta rechazó la consulta, health.state es unknown.
  • not_refreshed_yet: no se consultó, porque el número se actualizó hace menos de 60 segundos o ya hay otra actualización en curso. Los datos son los últimos guardados: vuelve a intentarlo en un momento.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

device*string

The device ID

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

Cuerpo de la respuesta

El estado de salud del número, con refresh_outcome.

application/json
  1. response
health*string
identity*string
meta_status*|

El estado del número en Meta en minúsculas (connected, flagged, restricted, banned, ...), igual que health.meta_status; null si todavía no se sabe.

entities*string
throughput_level*string

El nivel de rendimiento de envío que Meta le asigna al número: standard, high o unknown; null si todavía no hay datos.

history*array<>
meta_billing*|null
refresh_outcome*string
Valor en"not_refreshed_yet""failed""refreshed"
curl -X POST "https://example.com/devices/dev_Ac7Ku7iIZDXJTjdCu0UB1mX/health/refresh"
{  "health": "string",  "identity": "string",  "meta_status": "string",  "entities": "string",  "throughput_level": "string",  "history": [    {      "field": "string",      "previous_value": "string",      "new_value": "string",      "detail": "string",      "source": "string",      "occurred_at": "string"    }  ],  "meta_billing": {    "waba_id": "string",    "business_id": "string"  },  "refresh_outcome": "not_refreshed_yet"}

Esto es lo que se copia para tu IA

Cargando…