whatsapp.messages API

whatsapp.messages

live

List conversations or pass chat_id to read a thread. Supports pagination, unread conversations and an after timestamp. Channels, Communities and Broadcasts are not supported.

live coverage

Unipile: all inputs

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

Provider	Status
Unipile	live

Billing

Unit: per_call · unmatched results billed: no
Charged per read; an empty inbox is a successful read.

The exact quote is returned by /v1/inspect before every call and held with headroom on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.routergrowth.com/v1/run \
  -H "Authorization: Bearer $ROUTERGROWTH_API_KEY" \
  -d '{
    "capability": "whatsapp.messages",
    "input": {  },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "account_id": {
      "description": "Account name or ID from whatsapp.accounts. Optional when exactly one account is connected.",
      "type": "string"
    },
    "after": {
      "description": "ISO 8601 timestamp with timezone.",
      "type": "string"
    },
    "chat_id": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "limit": {
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "unread": {
      "default": false,
      "type": "boolean"
    }
  },
  "type": "object"
}

Normalized output fields

chats · messages · cursor