Ir para o conteúdo
WhatsMarketingDeveloper Hub

Linhas do WhatsApp

Seus números de WhatsApp e a saúde deles na Meta: qualidade, nível de mensagens, se estão pausados e por quê, e se falta registrá-los. Use para avisar sua equipe antes que uma linha no vermelho pare de enviar. Precisa de numbers:read.

Listar linhas

GET/numbers

qualityRating é GREEN, YELLOW ou RED (null se a Meta ainda não a avaliou). messagingLimitTier é o limite de pessoas diferentes por 24 h (TIER_250 a TIER_UNLIMITED). status: PAUSED_BY_META traz pausedReason e pausedAt. registration é REGISTERED, PENDING, PIN_REQUIRED ou ERROR, ou null se não consta que falte. A saúde é atualizada com a Meta no máximo uma vez por hora (healthCheckedAt).

Permissões: numbers:read

curl
curl "https://micuenta.whatsmarketing.es/api/v1/numbers" \
  -H "Authorization: Bearer $WM_API_KEY"
Node.js
const res = await fetch('https://micuenta.whatsmarketing.es/api/v1/numbers', {
  headers: {
    Authorization: `Bearer ${process.env.WM_API_KEY}`,
  },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://micuenta.whatsmarketing.es/api/v1/numbers",
    headers={"Authorization": f"Bearer {os.environ['WM_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
data = r.json()
PHP
<?php
$ch = curl_init('https://micuenta.whatsmarketing.es/api/v1/numbers');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('WM_API_KEY'),
  ],
]);
$data = json_decode(curl_exec($ch), true);
Resposta 200
{
  "data": [
    {
      "id": "5b2a9c1e-7d3f-4e8a-9b0c-1d2e3f4a5b6c",
      "number": "+34600111222",
      "displayName": "Ventas",
      "verifiedName": "Tu Empresa SL",
      "status": "ACTIVE",
      "pausedReason": null,
      "pausedAt": null,
      "qualityRating": "GREEN",
      "messagingLimitTier": "TIER_1K",
      "registration": "REGISTERED",
      "isTestNumber": false,
      "templatesApproved": 12,
      "uniqueRecipientsLast24h": 87,
      "healthCheckedAt": "2026-11-11T09:40:00.000Z"
    }
  ]
}