Ricky logorickyDocs

Listar números de WhatsApp

GET
/whatsapp-numbers

Todos los números de WhatsApp de la organización, también los desconectados, con su estado, su calificación de calidad y su límite de mensajes según la última lectura de Ricky en Meta.

Permiso: conversations:read.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*array<>
next_cursor*|

Pásalo como cursor para la página siguiente; null en la última página.

curl -X GET 'https://getricky.ai/api/v1/whatsapp-numbers'
{  "data": [    {      "id": "8f3c2a5e-6b1d-4c7a-9e2f-1a2b3c4d5e6f",      "name": "Casa Nativa",      "phone_number": "+50760001234",      "verified_name": "Casa Nativa",      "phone_number_id": "109876543210987",      "whatsapp_business_account_id": "102030405060708",      "connection_mode": "dedicated",      "status": "CONNECTED",      "disconnected_at": null,      "messaging_health": "available",      "quality_rating": "green",      "messaging_limit": "TIER_1K",      "inbound_processing_enabled": true,      "calls_enabled": true,      "connected_at": "2026-10-14T15:30:00.000Z",      "last_synced_at": "2026-10-14T15:30:00.000Z",      "name_status": "approved",      "business_profile": {        "about": "Óptica en Panamá",        "description": null,        "address": null,        "email": null,        "vertical": "RETAIL",        "websites": [          "https://casanativa.example"        ],        "profile_picture_url": null      }    }  ],  "next_cursor": "string"}