SDKs published; typed list responses
- SDKs:
@talkif/sdk0.1.1 (npm) andtalkif0.1.1 (PyPI) are published. Both auto-page list endpoints and expose typed errors — see SDKs. - API: list endpoints now return typed responses (
calls,contacts,campaigns, … plusmeta) instead of untyped arrays;offsetpagination starts at 0. - Calls: the call list is now
GET /calls(replacing/calls/historyand/calls/active); usestatusto narrow to live calls. It gains filters —status,direction,source,phoneNumber,flowId,contactId,campaignId,scheduleId,providerType,isLead,search, and sorting. - Integrate: Agent Skills for Claude Code, Codex, Cursor and any Agent-Skills-compatible tool —
npx skills add Talkif-ai/skills— covering every job in these docs, verified against the public API. See Build with AI agents. - Docs: docs.talkif.ai restructured around tasks — Getting started, Concepts, Build agents, Telephony, Run calls, Integrate, Account and billing, Reference. Every previous URL redirects.
System Prompt and Agent Prompt
- Builder: Prompts are now two clearly separated fields. The System Prompt is the call’s persona, set once on the Main Agent and inherited by every other agent; the Agent Prompt is each agent’s own job. Existing flows were migrated automatically. See Write prompts.
- Builder: Flows built by the Assistant now include spoken-output rules on the main agent by default (short replies, no lists read aloud).
- Models: Models no longer offered by any template were retired; ElevenLabs Multilingual v2 removed in favour of the v3 and Flash models.
- Calls: A contact skipped mid-campaign (Do Not Call, opt-out, manual skip) no longer keeps the campaign in running after every other contact is done.
Contact-local call windows; ElevenLabs v3
- Calls: Campaign call windows are evaluated in each contact’s local time, so a list spanning time zones is called at sensible hours everywhere. See Campaigns.
- Calls: Campaign pacing is budgeted against your concurrent-call limit, and busy agents are protected during platform scaling — fewer mid-call drops under load.
- Builder: Campaign screens rebuilt around the new analytics; raw call errors no longer appear in the campaign summary.
- Models: ElevenLabs v3 conversational voices are available for text-to-speech.
- Calls: A call now ends cleanly, with a recorded reason, when a speech or language service becomes unusable mid-call, instead of hanging silently.
- Telephony: Meta Lead Ads form mappings can declare the phone country for their leads, so numbers submitted without a country code are normalised correctly.
Reasoning effort per model; campaign analytics
- Builder: Models that support a reasoning effort setting now expose it, and every model defaults to the least thinking it allows — the right default for live conversation. Models that reject a temperature (current GPT-5 and Claude families) no longer show one. See Choose models and voices.
- Models: Catalogue corrected from live-call results; retired models removed; the Claude 5 family added.
- Calls: Campaign analytics gain outcome, attempt-distribution, failure-cause and duration-histogram views, and campaign counters no longer drift. See Campaigns.
- Telephony: WhatsApp calls from callers Meta identifies by business ID rather than phone number are now answered; a single unrecognised WhatsApp event no longer drops the events around it.
- Calls: Releasing a phone number no longer interrupts Meta Lead Ads calls already in flight for that number.
Meta Lead Ads qualification and call windows
- Meta Lead Ads: A dedicated qualification pass decides each lead’s funnel stage, with AI stage suggestions behind a confidence gate, a hold window, and manual override from a needs-review queue.
- Meta Lead Ads: Per-form qualification criteria, a user-configurable call window and concurrent-call limit on the lead campaign; the campaign schedules its own lead calls.
- Meta Lead Ads: Drill-down navigation (Overview → Page → Form → Leads), source and integration filters, and per-lead actions: retry the Conversions API send, add to Do Not Call, schedule a call.
WhatsApp Business Calling, Assistant, six providers, web calls
- Telephony: WhatsApp Business Calling — connect a WhatsApp Business Account (Embedded Signup or credentials), register numbers, and your agents answer WhatsApp calls with no telephony charge. The same digits can exist as a phone line and a WhatsApp number. See WhatsApp Business Calling.
- Builder: The Talkif Assistant — a chat in the dashboard that answers questions about your account, proposes flow edits as reviewable diffs, and builds a complete flow from a description.
- Models: Six new providers — Google Gemini TTS, Google Cloud STT, xAI Grok STT and TTS, Amazon Transcribe, Rime TTS — and the LLM catalogue refreshed with official pricing. ElevenLabs voice browser gains gender, age, language and accent filters; shared-library voices can be added to your account.
- Integrate: Web calls — put a voice agent on any web page with a publishable key and the browser SDK; and a real-time events WebSocket for account-wide and per-call events. See Real-time events.
- Calls: Failed calls carry the carrier’s real failure code and reason instead of a generic failed.
- Calls: Honest interruption accounting — the transcript shows what the caller actually heard, and wasted (generated but unspoken) TTS characters are reported per call. Per-contact call timeline; call history gains phone/name search, provider filter, lead filter and server-side sorting.
- Calls: Timezone-honest schedules — pick an IANA zone, preview in local time, default to the contact’s zone. See Schedules.
- Builder: End Call as a shared canvas node; provider nodes auto-connect to the Main Agent when dropped; per-flow turn-taking configuration.
- Billing: Trial credit, coupons and promotional balances; Assistant usage with a free monthly allowance, then billed to balance.
- Meta Lead Ads: Leads grouped under auto-created campaigns; dataset picker instead of pasting an ID; per-lead attempts, manual recall and a clickable funnel; moved to Call Center → Meta Leads.
Call lifetime controls, webhook signing, Meta Lead Ads
- Builder: Silence handling (“are you still there?”, then a polite hang-up) on by default, and a per-flow maximum call length with a graceful goodbye.
end_callnow lets the farewell finish instead of hanging up instantly. See Transfer and end calls. - Integrate: Webhook signing — every request to your endpoints carries a
Talkif-Signature(HMAC-SHA256) once you create a per-account secret; secrets are rotatable with an overlap window. See Webhooks. - Integrate: Meta Lead Ads — connect a Facebook Page, map lead forms to flows, and Talkif calls every new lead within seconds, reporting funnel stages back to Meta’s Conversions API. See Meta Lead Ads.
Voicemail detection; call lifecycle
- Calls: Voicemail detection on outbound calls — recognise an answering machine and leave a message (fixed or composed) or hang up, with its own cost line. See Transfer and end calls.
- Calls: Single call state machine with an automatic reconciler — a call can no longer get stuck in an in-progress state; stuck calls are ended with reason
reconciled. - Calls: Admission is region-aware, so a call is only accepted where an agent can actually serve it.
- Calls: Lower browser-call connection latency.
- Developer: Account ID and Organization ID shown on the Developer page; link to API documentation.
Flow functions
- Builder: Flow functions — the agent calls your HTTP endpoints mid-conversation. Structured requests (path, query and body parameters as JSON Schema), with each parameter bound to the model, to call context (caller, call, flow) or to a static value; values bound to context are never shown to the model. Attach a function to any agent with the HTTP Request node. See Call your backend.
- Builder: Functions (called by the model) and actions (run automatically around an agent’s turn) are now distinct concepts.
- Models: Settings a model doesn’t support — a temperature on a reasoning model, for example — are stripped automatically rather than failing the call; the builder hides them.
Public REST API, flow versions, API keys
- API: The public REST API at
api.talkif.aiwith OpenAPI documentation and an error catalogue endpoint. - API: API keys with scopes, IP allowlists, expiry, usage tracking and error monitoring, managed under Developer → Credentials. See Authentication.
- Builder: Flow versions — every publish is an immutable version with notes, a semantic diff between versions, rollback, and phone numbers that follow latest or are pinned to a version. See Flows and versions.
- Builder: Voice browser with filters for TTS nodes; ElevenLabs shared voices; a prompt editor dialog on agent nodes.
- Calls: Unified call timeline with every speech event, function calls per turn, and the model used per message; redesigned call detail and cost breakdown; end reasons shown in the UI.
- Billing: Charge history — every billable event (call usage, number purchase and rental, analysis, recording storage, adjustments) with status and line items, alongside the transaction ledger. Payment-method health — cards show declined / expired / blocked with the decline reason, auto-recharge skips unusable cards, and cards can be labelled. See Credits and payment.
- Telephony: Redesigned number purchase; phone-number change with SMS verification.
- Calls: Faster browser test calls.
Recording, Do Not Call, calling hours, data export
- Calls: Call recording with playback and download, per-recording storage billing, and a retention period you set. Delete a recording on demand. See Transcripts and recordings.
- Calls: Do Not Call list — numbers on it are never dialled, by any path; campaign contacts are skipped with the reason. See Do Not Call.
- Calls: Legal calling hours enforced by the recipient’s jurisdiction (US: 8 am – 9 pm local, TCPA), with timezone derived from area code when the contact has none.
- Builder: Dynamic prompts —
{{contact.*}},{{call.*}},{{system.*}}variables with helpers, resolved at call time; AI-assisted prompt authoring; per-flow analysis instructions. See Write prompts. - Builder: Start from a blank flow, or a template.
- Calls: Campaign contacts are snapshotted at enrollment — a contact edited mid-campaign is still called with the data the campaign started with, so every retry sees the same context.
- Telephony: Two regions (EU and US) — calls are served from the closer one; SIP numbers activate immediately (no verification call).
- Billing: Phone-number prices fetched live from the carrier per country; direction-based (inbound/outbound) telephony pricing; public pricing endpoint.
- Account: Data export — everything as one JSON file, email-confirmed, GDPR Article 20; account name and deletion from Settings → General; legal document acceptance with change notices.
- Dashboard: Onboarding checklist; toast notifications for every action.
- Security: SIP/Twilio credentials and two-factor secrets encrypted at rest; personal data redacted from logs.
Campaigns, templates, OpenAI, Google sign-in
- Calls: Campaigns — call a contact list with a flow, with concurrency, call windows, an end time and per-contact outcomes; skipped contacts are previewed with reasons before you start. See Campaigns.
- Calls: Two-layer call status: the telephony leg (
status) and the agent leg (agentStatus) reported separately. See How a call works. - Builder: Flow templates to start from; an End Call function for graceful termination; structured validation errors that name the field.
- Builder: OpenAI language models; Cartesia text-to-speech; ElevenLabs voice filtering; Soniox languages. Multi-provider STT/TTS per flow.
- Contacts: Import from CSV, JSON and vCard with phone-number normalisation and a country-code selector; tags with multi-tag filtering; export.
- Telephony: Caller ID on SIP calls; automatic carrier-edge selection from your carrier’s location; timezone detection from phone numbers.
- Billing: Auto-recharge; Stripe-hosted payment methods and 3-D Secure; cost breakdown per call with cached and reasoning token pricing for every LLM provider; telephony billed at the carrier’s actual per-call price.
- Account: Sign in with Google; organization invitations; personal and organization accounts.
- Calls: Faster first response — the greeting is prepared while the call connects; idle calls end automatically.
New platform: calls, queueing, analytics
The current Talkif platform, rebuilt from the ground up. Everything below this entry is the product as it exists today; earlier history isn’t listed.
- Calls: Every call runs through a capacity-managed queue — calls beyond your concurrent limit wait and are placed automatically as slots free, in priority order. Call source (direct, scheduled, campaign) is tracked on every record.
- Calls: Post-call insights — summary, sentiment, intents, action items, outcome — generated automatically, with contacts created or enriched from what callers say.
- Calls: Full call details with related contact, campaign and flow, and per-service cost breakdown priced dynamically per model.
- Telephony: Bring your own Twilio account, or a SIP trunk; phone-number search with full filters (area code, city, state, ZIP, pattern).
- Account: Organizations with members and roles; account deletion with a grace period; multi-factor authentication.
- Dashboard: Real-time updates for call status, balance and notifications; analytics dashboard with call quality.
- Builder: Flow status lifecycle (draft → testing → published → archived) and flow tags.