Skip to main content
GET
/
v1
/
businesses
/
{businessId}
/
get
/
quality_signals
Get Quality Signals
curl --request GET \
  --url https://api.example.com/v1/businesses/{businessId}/get/quality_signals
Retrieve your WhatsApp account’s current quality signals — the messaging limit tier and quality score that Meta assigns based on your message delivery and customer feedback. Use these to monitor your account health and understand how many business-initiated conversations you can send per day.

Messaging limit tiers

Meta defines four tiers for business-initiated conversations in a rolling 24-hour period:
Tier valueConversations per 24 hours
WHATS_APP_MESSAGE_LIMIT_TIER_1K1,000 unique customers
WHATS_APP_MESSAGE_LIMIT_TIER_10K10,000 unique customers
WHATS_APP_MESSAGE_LIMIT_TIER_100K100,000 unique customers
WHATS_APP_MESSAGE_LIMIT_TIER_UNLIMITEDUnlimited
The messagesLimitTier field only updates when Meta registers a change. If your account is new, it may appear as WHATS_APP_MESSAGE_LIMIT_TIER_UNSPECIFIED until your first tier assignment. This is expected and does not indicate an error. See Meta’s messaging limits documentation for full details.

Endpoint

GET https://api.connectly.ai/v1/businesses/{businessId}/get/quality_signals

Response

{
  "entity": {
    "signals": [
      {
        "whatsappQualitySignals": {
          "phoneNumber": "+16501234567",
          "wabaId": "649852411234567",
          "messagesLimitTier": "WHATS_APP_MESSAGE_LIMIT_TIER_UNSPECIFIED",
          "qualityScore": "WHATS_APP_QUALITY_SCORE_HIGH"
        }
      }
    ]
  }
}
Response fields:
FieldDescription
whatsappQualitySignals.phoneNumberThe WhatsApp phone number these signals apply to.
whatsappQualitySignals.wabaIdYour WhatsApp Business Account ID.
whatsappQualitySignals.messagesLimitTierYour current messaging limit tier. UNSPECIFIED if not yet assigned.
whatsappQualitySignals.qualityScoreYour current quality score: HIGH, MEDIUM, or LOW.

Example

curl -X GET "https://api.connectly.ai/v1/businesses/{businessId}/get/quality_signals" \
  -H "X-API-Key: YOUR_API_KEY"