companyLogo

Domestic SIMs and daily caps

A SIM only texts and calls numbers of its own country, on any operator: never abroad, and texts from abroad are ignored. Every device also keeps daily caps, the same for everyone.

  1. Each SIM: up to 100 SMS and 100 calls a day (calls are counted, not minutes).
  2. Each WhatsApp number: up to 50 new conversations and 200 messages a day, at most 5 messages to the same person, and 2 more for each reply from that person that day.
  3. A message no SIM of yours can send waits for the next SIM of that country, or fails at once if you have none there.

The caps keep your lines far below what operators and WhatsApp treat as bulk or commercial use. Staff may change them for everyone.

Seeing your limits

Every limit is shown with how much is used today and when it resets (midnight UTC). Nothing is hidden behind a generic error.

  • GET /v1/echo/usage: the limits, and what each device has used today. Add ?to=+962XXXXXXXXX (or an email address) to see which methods can send there right now.
  • A limit is { scope, used, max, resets_at, resets_in_s }. Scopes: per_chat (messages to one person), wa_messages, wa_new_chats, sms, calls, emails.
  • A code that cannot go because of a limit is refused at once with 409 daily_limit_reached and the limit (it goes through Echo devices instead when your account and the app allow it).
  • A message held back or failed by a limit carries it: GET /v1/echo/messages/ID has limit, and the echo.message.failed webhook has it too.
GET /v1/echo/usage

Documentation

Echo by ibotek