Traffic shape

  • Keep concurrency modest. A handful of in-flight requests is plenty for most integrations; large bursts cause queueing on our side and timeouts on yours.
  • Prefer endpoints that return a collection over fan-out calls. If an endpoint accepts a list of IDs, use it instead of looping one-by-one.
  • Walk paginated endpoints to completion sequentially. Don't request many pages in parallel — order matters for cursors, and parallel paging multiplies load without buying you much speed.
  • Poll only as often as you actually use the data. Most state in Telavox does not change second-to-second; polling at one-minute or longer intervals is almost always fine, and gentler intervals (5–15 minutes) are better for background sync.
  • Cache responses on your side where it's safe to. Honour any Cache-Control or ETag headers we send; refetching unchanged data is the easiest waste to eliminate.