# Estado de envío: ¿puede iniciar conversaciones este número?

`GET /v1/connections/{id}/sending-status`

Antes de una campaña, `GET /v1/connections/{id}/sending-status` (`{id}` = `conn_…` o tu `externalId`) te dice si pausar **antes** de juntar rechazos y qué tiene que arreglar tu cliente. Sale de lo que ya leímos de Meta: no llama a Meta.

**`canSend`**: `available`, `limited`, `blocked` o `unknown` (todavía sin leer), con `canSendReason`. Responder dentro de las 24 h de un cliente no depende de esto.

**Por qué.** `entities[]` (cuenta de WhatsApp, portafolio, app y número, cada uno con su veredicto y sus códigos de Meta) y `reasonCodes[]` con el código original: `141006` medio de pago, `141010` verificación del negocio, `131042` si Meta sigue rechazando envíos por el pago. Además `businessVerification`, `accountReviewStatus`, `qualityRating`, `payment` (`ok`, `missing` o `unknown`; nunca datos de tarjeta) y `links` a la página de Meta para arreglarlo.

**Límite diario.** `messagingLimit.tier` y `dailyLimit`: Meta lo aplica al **portafolio**, compartido por todos sus números y proveedores. El consumo en 24 h móviles y la próxima liberación no los expone Meta: vienen `unknown`, nunca aproximados. Igual `payment.fundingSource` y `payment.creditLine`.

**Releer.** Si tu cliente dice que ya lo arregló: `POST /v1/connections/{id}/sending-status/refresh` relee en Meta (sólo lectura), una vez por número cada 10 min; antes, `429 RATE_LIMITED` con `Retry-After`.

**Avisos.** Suscribí el webhook a `connection.sending_status_changed` (por nombre) y te llega cada cambio con `changed`, la firma anterior y el estado completo.

## Ejemplos

### cURL

```bash
# 1) before a campaign: can this number start conversations?
curl https://api.waiaconnect.com/v1/connections/conn_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/sending-status -H "Authorization: Bearer wc_live_YOUR_API_KEY"
# → { "sendingStatus": { "canSend": "blocked", "reasonCodes": [141006],
#       "payment": { "status": "missing", "owner": "client", … },
#       "messagingLimit": { "tier": "TIER_250", "dailyLimit": 250, "used": "unknown", … }, … } }

# 2) your customer says they fixed it: re-read from Meta (once per number every 10 min)
curl -X POST https://api.waiaconnect.com/v1/connections/conn_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/sending-status/refresh -H "Authorization: Bearer wc_live_YOUR_API_KEY"
```

### Node.js

```javascript
const H = { "Authorization": "Bearer wc_live_YOUR_API_KEY" };
const { sendingStatus: s } = await (await fetch("https://api.waiaconnect.com/v1/connections/conn_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/sending-status", { headers: H })).json();
if (s.canSend === "blocked" || s.canSend === "limited") {
  // pause the campaign and tell your customer what to fix
  console.log(s.reasonCodes, s.payment.status, s.businessVerification.status, s.links.paymentSettings);
}
```

### PHP

```php
<?php
$ch = curl_init("https://api.waiaconnect.com/v1/connections/conn_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/sending-status");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer wc_live_YOUR_API_KEY"]]);
$s = json_decode(curl_exec($ch), true)["sendingStatus"];
if (in_array($s["canSend"], ["blocked", "limited"])) {
  // pause the campaign; $s["reasonCodes"], $s["payment"]["status"], $s["links"]["paymentSettings"]
}
```

### Python

```python
import requests
H = {"Authorization": "Bearer wc_live_YOUR_API_KEY"}
s = requests.get("https://api.waiaconnect.com/v1/connections/conn_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/sending-status", headers=H).json()["sendingStatus"]
if s["canSend"] in ("blocked", "limited"):
    print(s["reasonCodes"], s["payment"]["status"], s["links"]["paymentSettings"])  # pause + guide your customer
# after your customer fixed it (once per number every 10 min):
requests.post("https://api.waiaconnect.com/v1/connections/conn_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/sending-status/refresh", headers=H)
```

## Notas

- Un número de otra cuenta da el mismo `404 CONNECTION_NOT_FOUND` que uno que no existe.
- `readAt` dice cuándo se leyó; se relee cada 12 h y con el refresh.
- `message.status` trae el código original de Meta (`errors[]`, con `subcode` en un rechazo del envío), la etapa (`stage`: `send` o `delivery`) y el `pricing` de Meta (`billable`, `category`, `type`) para conciliar.