Trovacast

Get started

Build on Trovacast

One REST API for WhatsApp, SMS, email and voice — calls, call control, IVR flows, numbers and AI voice agents — with signed webhooks, consent built in and every request safe to retry.

Your servers manage contacts and their consent; send WhatsApp templates and replies, SMS and email; order numbers and answer their calls with a call flow, your own application or an AI agent; place calls to your own voice agent, a flow, an AI agent or your team; act on live calls; and hear about every delivery, reply and call outcome through signed webhooks — without handling Meta's tokens or a carrier's.

What you can build

ProductWhat the API does today
WhatsAppApproved templates any time with consent; text, media, buttons, lists and reactions inside the 24-hour window; replies on any thread; hosted onboarding for your customers' numbers.
SMSDLT-registered templates in India from your registered headers, consent by TRAI category, the promotional window enforced.
EmailTemplates or HTML from your own verified domain, with suppressions, bounces and complaints handled.
CallsPlace a call run by your own agent over a WebSocket, by a call flow or by one of your AI agents, or bridged to a number or a desk agent (customer first, or agent first); answering-machine detection, recordings, hang-ups and call events.
Call control and conferencesOn a live call: speak, play, gather key presses or speech, send DTMF, hold and resume, transfer to a number, a queue, a flow or an application, pause the recording, hang up — or open the call to more parties.
Call flows and inbound callsVersioned IVRs — menus, speech gathers, business hours, queues, voicemail and an AI agent as a step — that answer your numbers or run outbound calls; or your own answer URL.
NumbersSearch, order and release numbers paid from your prepaid credit, route their calls, register them as SMS senders, and port your own numbers in.
AI agentsVoice agents with their own instructions, voice and tools your servers answer, data extracted from every call, and each call's transcript and AI summary over the API.
QueuesCall queues for your team's desk: members, tiers and skills, hold audio and overflow.
Contacts and consentOne contact per phone number, consent per channel with evidence, export and erasure for data requests.
BroadcastsOne approved template to an audience — by tags, attributes or ids — now or at a set time.
Verify and LookupOne-time codes by SMS, WhatsApp, a voice call or email; a phone number's validity, type and India do-not-call status.

The basics

TopicIn short
Base URLhttps://api.trovacast.com
ProjectsYour workspace in the console is a project; the API calls it an organization (organizationId).
AuthenticationAuthorization: Bearer tc_live_… — API keys, each with its own scopes.
FormatJSON in and out, camelCase, timestamps in ISO 8601 UTC.
ListsCursor-paginated as { data, nextCursor } — Pagination.
ErrorsA stable code beside every message; branch on the code — Errors.
RetriesEvery write accepts an Idempotency-Key — Idempotency.
Limits600 requests a minute per key, reported in X-RateLimit-* headers — Rate limits.
ContractGET /v1/openapi.json (OpenAPI 3) — what the reference, SDKs and Postman collection are generated from.
ChangesAdditive only within v1 — Versioning, Changelog.

Built for compliance

  • Consent, the WhatsApp service window, DLT rules, suppressions and the template's current category are checked when a message is sent, not only when it is queued.
  • A project key sees one project; another project's records answer 404. Phone numbers are masked to their last four digits on reads.
  • Export everything held about a contact, or erase it for good — media, recordings and stored payloads included — with one call each. See Data requests.
  • Webhook payloads are signed, retried for about three days and readable for 30.

Get a key

A project administrator creates keys in the Trovacast console under Settings → Developers, choosing exactly what each may do. New to Trovacast? Talk to us to open an account.