1. Quickstart
CallerAPI Documentation
  • Quickstart
  • Use cases
    • For carriers (MNOs/MVNOs)
    • CPaaS platforms
    • Cloud communications providers
    • SIP trunking providers
    • PBX/Cloud PBX
    • UCaaS vendors
  • Account
    • Balance and email
      GET
  • Spam protection
    • Voice firewall
      • Get started
      • Quickstart
        • What you get
        • Before you start
        • Test with a recording
        • Connect your switch
        • Switch notes
        • Twilio and Telnyx
        • Send text instead of audio
      • Verdicts
        • Read a verdict
        • What to do with a verdict
        • Block a caller
        • Events and webhooks
      • Honeypot
        • Hand a call over
        • Audio, events, and limits
      • Reference
        • Endpoints
        • Errors
        • Limits and thresholds
        • Production checklist
      • REST
        • What this deployment can do
        • List the verdict categories
        • List the honeypot personas
        • Score a transcript or a recording
        • List your recent sessions
        • Get one session with verdict and intel
        • Twilio voice URL for a screened number
        • Preview the Twilio TwiML
        • Telnyx voice URL for a screened number
        • Twilio voice URL for a honeypot number
        • Telnyx voice URL for a honeypot number
      • WebSocket
        • Live scam filter stream
        • Honeypot stream
    • Daily spam reports
      • Webhook
        • Subscribe to daily reports
        • Unsubscribe from daily reports
        • List webhook subscriptions
        • Manual dispatch of reports
        • Test webhook
      • REST
        • Fetch daily spam reports
    • 15 days spam CSV snapshot
      GET
    • Spam score + HLR
      GET
  • Mobile SDK
    • Get started
    • Quickstart
      • What you get
      • Get your keys
      • Android
      • iOS
      • Flutter
      • React Native
      • Check it works
    • Call screening
      • What each platform can do
      • Android call screening
      • iOS prerequisites
      • iOS add the extension
      • iOS test on device
    • Reference
      • Methods
      • Errors
      • Limits and billing
      • Troubleshooting
  • Data partners
    • Partner tems & docs
    • Upload spam reports
    • Upload contacts
  • Fraud prevention
    • Ported date
    • Porting history
    • Online presence
    • KYC user identity
  • Schemas
    • Spam protection
      • Spam score request
      • Business info
      • Carrier info
      • Complaint (without number)
      • Daily spam reports request
      • Complaint (with phone)
  1. Quickstart

Send text instead of audio

When your platform already runs speech recognition, send the words and skip the audio. This removes the transcription cost from the call and works on any platform that can open a WebSocket.

How#

1.
Open the socket and send the start message as on Connect your switch.
2.
Send one text frame per finished utterance:
{"type": "transcript", "text": "This is the IRS. There is a warrant for your arrest.", "track": "inbound"}
FieldDefaultMeaning
textrequiredThe words. Empty text is ignored.
trackinboundinbound is the remote caller. outbound is the local party, labelled callee.
The server treats every transcript message as one final utterance. Do not send interim results. Extra fields are ignored.

Rules#

You can send audio and text on the same socket. Both feed one transcript.
Send the caller's words. Send the called party's words as outbound only when you want them in the transcript. They are not scored.
Events, verdicts, and session.ended are the same as for audio. See Events and webhooks.
The filter is still charged per started minute of session time.

After the call#

To score a finished transcript in one request, use Score a transcript or a recording instead. It costs 2 credits per request and needs no socket.
Modified at 2026-09-18 16:56:51
Previous
Twilio and Telnyx
Next
Read a verdict
Built with