GET /v1/connections lista os números da conta (somente leitura). Cada um traz o seu id (conn_…), o seu phoneNumberId (o id do número na Meta — o valor que o campo from aceita ao enviar), label/externalId (a sua identidade de revendedor), displayPhone, e saúde: metaStatus (connected/pending/flagged/restricted/disconnected), qualityRating, messagingTier. A única coisa mutável pela API é a identidade de revendedor: PATCH /v1/connections/:id (label, externalId, monthlyMessageLimit, notes).
curl https://api.waiaconnect.com/v1/connections \
-H "Authorization: Bearer wc_live_YOUR_API_KEY"
# → { "connections": [ { "id": "conn_…", "label": "…", "externalId": "…",
# "displayPhone": "…", "metaStatus": "connected", "qualityRating": "…" } ] }externalId é único por conta e viaja em cada webhook (envelope.connection.externalId) → você não precisa de uma tabela de mapeamento.