Conversation Data API
Every conversation your agents handle can flow automatically into a system you already use — your own dashboard, a CRM, a reporting tool, or a spreadsheet.
This page is the business view: what you can send, what it is useful for, and what to ask your developer for. The technical reference lives in the developer documentation.
Why it matters for your business
Voicetta shows you every conversation inside app.voicetta.com. That is the right place to review a Guest exchange, listen to a recording, or check a quality score. It is not always the right place for everything else.
Three situations where sending the data somewhere else changes what you can do:
- Your team already lives in another tool. If your front desk works in a PMS and your sales team works in a CRM, a Guest conversation is worth more attached to the record they already have open than in a second tab they have to remember to check.
- You resell Voicetta under your own brand. Agencies and software vendors run Voicetta behind their own product. Your clients log into your dashboard and see their Guest conversations there, with no Voicetta branding anywhere in the experience.
- You report on more than conversations. Quality scores next to revenue, response times next to staffing — the joins that matter usually happen in your warehouse or BI tool, not in ours.
In each case the value is the same: the conversation stops being something a person has to go and look up, and becomes something your existing systems already know about.
What you can send
Three kinds of record, each available separately, so you send only what a given system needs.
| Record | What it contains | When it is ready |
|---|---|---|
| A voice call | Transcript, summary, what the Guest wanted, quality scores, a recording link | Seconds after the call ends |
| A text message | The Guest's SMS or WhatsApp message and the reply your agent sent | Within about 30 seconds |
| A finished text conversation | The whole exchange, summarised and graded, with quality scores | About 30 minutes after the last message |
Text messages and finished conversations are two views of the same thing, and most teams end up using both. The messages are the live feed — useful for a screen someone watches during the day. The finished conversation is the outcome — useful for reporting, because that is when the summary and the quality scores exist.
The half-hour wait on the third one is not a delay we could remove. A text conversation is not over when a message arrives; the Guest may reply in ten minutes. Grading waits for the conversation to actually finish, so the scores describe the whole exchange rather than a fragment of it.
Two ways to receive it
Sent to you automatically. You give us a web address and we deliver each record there as it happens. This is the normal choice: your data stays current with nothing to schedule.
Fetched when you ask. Your developer requests records over an API — useful for loading history, for a nightly report, or for catching up if your system was offline.
Most integrations use both: automatic delivery to stay current, and fetching to backfill everything from before the integration existed.
Choosing what leaves Voicetta
You control what each destination receives, block by block: Guest contact details, the transcript, the summary, quality scores, costs, and so on. Anything you do not tick is never sent.
This is worth a moment's thought rather than ticking everything. If a dashboard only ever shows a summary and an outcome, sending it full transcripts and phone numbers means Guest data sitting in a system that has no use for it — more to secure, and more to explain in your own privacy documentation. Send what the destination actually displays.
Cost figures are off by default, because they reveal what a conversation cost to run. Turn them on when the destination is yours, leave them off when a client logs into it.
One note on text costs: the cost shown on a message or a text conversation is an indicative rate, not a billed amount. Text messaging is not deducted from your wallet per message, so those figures are useful as an approximation and should not be used for invoicing. Your Voicetta invoice remains the source of truth — see Billing, Wallet, and Pricing.
Setting it up
- Open Settings → Developers in app.voicetta.com.
- Add a destination address, and tick which records it should receive and which blocks of data each should carry.
- Press Send test event to confirm the receiving system answers correctly. You can do this as often as you like.
- Ask us to enable delivery for your workspace.
- Watch the delivery log for the first day. It shows every attempt, the record type, and the response.
For fetching rather than receiving, create an API key on the same screen and choose which blocks it may read. Keys and signing secrets are shown once, at creation — if one is lost, replace it rather than asking us to look it up, because we genuinely cannot.
Turning a record type on is not retroactive. Tick text messages today and you receive messages from today onward; anything earlier is available by fetching it. Worth knowing before someone concludes the integration is broken.
Do you need a developer?
For receiving records into a workflow tool — n8n, Make, or Zapier — no. Those tools have a webhook step that receives deliveries with no code involved, and there is a page on exactly that with the four settings that decide whether it holds up in production.
For anything that writes into your own product or database, yes. Point them at the developer documentation; it is written to be read start to finish in an afternoon, and a working integration is usually a day's work rather than a project.