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.
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ó).staleestrue; si Meta rechazó la consulta,health.stateesunknown.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.
httpAuthorizationBearer <clave>device*stringThe device ID
^dev_[A-Za-z0-9]{23}$El estado de salud del número, con refresh_outcome.
application/json- response
health*stringidentity*stringmeta_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*stringthroughput_level*stringEl 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*|nullrefresh_outcome*string"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"}Reiniciar la sesión de un número PUT
Sirve para borrar los datos del número conectado en un lugar de tu plan, por QR u oficial, y conectar ahí un número distinto: es «Borrar datos» en el panel. El lugar sigue ocupado y se conserva el alias. No se puede deshacer. Requiere Números de WhatsApp → Crear, conectar y borrar.
Ver el nombre de usuario de un número GET
Úsalo para consultar el nombre de usuario de WhatsApp de un número oficial: el que informa Meta o, si Meta no devuelve ninguno, el último que se reservó.