Listar números

Los números oficiales de WhatsApp (Cloud API) del negocio. id es el channel_uuid de POST /messages/send y number es el from_phone_number de POST /send-template.

GET/phone-numbers

Autenticación

Este endpoint se autentica con tu API key enviada en la cabecera X-API-Key (formato ek_live_...). Puedes crearla en Configuración del negocio → Claves de API.

Ejemplo de solicitud

bash
curl -X GET "https://api.eclecticlabs.com/api/external/v2/phone-numbers" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json
{
  "phone_numbers": [
    {
      "id": "3b7e8d21-4c5f-4a90-8e12-6f0a1b2c3d4e",
      "number": "56912345678",
      "display_name": "Mi Tienda",
      "alias": "Ventas",
      "status": "CONNECTED",
      "quality_rating": "GREEN",
      "can_send": true,
      "connection_issue": null,
      "whatsapp_account_id": "c0a8012e-7d3b-4f6a-9c21-5e4d3b2a1f00"
    }
  ]
}

status y quality_rating son los que informa Meta, según la última actualización. can_send es false cuando el número no puede enviar en este momento, y connection_issue explica por qué.