Example: Calls Transcriber

Set Up in 5 Minutes

The following video shows how to set up a complete system that records and transcribes phone calls. Start to finish setup in just 5 minutes.

Using Speechnotes, JustCall, & Zapier.

Get Started

Get started by opening your account on Speechnotes Files Transcription Service.
Purchase credits if necessary. No subscription, simple pay as you go. You decide when and how much transcription minutes to buy.
Then - tap on the 'API & WEBHOOKS' button, to get everything you need for starting your 100% hands free automatic work flows.

When to Use?

When webhooks

Use Speechnotes' Transcription Webhooks when you want to automatically handle transcription results, by your own server, CMS, or web automation tools such as Zapier, Make, and more.

For instance, you may want to automatically save transcriptions in your Google Drive. Or, perhaps add this as a record in your CMS / CRM database, etc.

When transcription API?

Use the transcription API when you want to delegate the process of sending files for transcription to your bots instead of manually doing it yourself. For instance - you can write a script that uploads all files in a specific folder on your computer. Or, you can automate transcriptions of any voice mail message you receive. Automatically transcribe any phone conversation recorded, etc.

Example use cases

There are many use cases. API & Webhooks are simply the tools - so you can build whatever automation you want around it. Here are some main use cases:

Zapier integrations - easy - no coding - unlimited automations
Invite link to Speechnotes' on Zapier:

- Speechnotes' on Zapier →
Automatically transcribe all phone conversations done on services that record them such as JustCall or its likes. Here's a flow:
1. Upon end of conversation, JustCall sends a webhook to Zapier with the recording's url
2. Zapier sends an API call to Speechnotes' Transcribe API with the recording's url as received from JustCall
3. Speechnotes transcribes the call
4. Speechnotes sends a webhook with the transcription results to Zapier
5. Zapier receives the transcripts and sends it to your CRM or Google Drive for archiving
Automatically upload all transcription results to your own cloud storage such as Google Drive, Dropbox, etc.
Automatically upload transcripts to CRM

Zapier Integration

Zapier integrations offer easy drop-in - no coding required - infinite possibilities for automations.
Invite link to Speechnotes' on Zapier:

- Speechnotes' Zapier integration →

Whether it is to automatically transcribe recordings, or to automatically store all Speechnotes transcripts on Google Drive, Dropbox, or in your CRM connected to client profiles. It's all possible. No code required (but yes technical understanding).

Webhooks - Hands On Guide

Speechnotes will send transcription results to the url defined in your account.

Tip: In order to verify it was indeed sent by us - the message from Speechnotes will include the API SIGNATURE - so you can compare it to the signature you have. The signature is unique to your account - so no one else knows it.

Here's the definition of the POST that will be sent to your url:

method: POST
url: as defined by you in your account https://as.defined.by.you.in.your.account
Body: the body of the message is a long string that represents a JSON, with the following fields:
- key: success value: trueorfalse Tells you if something went wrong
- key: (optional key, exists only if success was true)fullText, value: The whole transcript This is the whole point of this payload
- key: (optional key, exists only if job failed)errorCode, value: The stage that failed
- key: (optional key, exists only if job failed)errorMessage, value: Human readable message
- key: fileUrl, value: https://some_url.com/file.mp3The url of the submitted file. If it was uploaded from device - then it will be "device_uploaded"
- key: jobId, value: SOME_IDThe id of the job on Speechnotes' server, set for each job by Speechnotes
- key: fileName, value: file_nameThe name of the file as received or derived from url
- key: apiKey, value: YOUR_API_KEYunique per user
- key: apiSignature, value: YOUR_API_SIGNATUREUnique per user and secret, so you can verify this POST was indeed by Speechnotes' servers by comparing the received value to the API SIGNATURE as you can view in your dashboard.
- key: api_custom, value: some-user-sent-stringSimply passing on the value that was sent when uploading the job via API. You can use this to pass more data on that job, such as recording id, client id, etc.
- key: remainingDollarBalance, value: 4.3Dollar balance remaining after the job. As all values this is also represented as a string
Here's a body example:
{ "api_custom":"callIdOnJustCall=jhgsd876dfkjhdoiu", "jobId":"c8ZNJjiR7j5cCuzax2zT", "fileName":"calljhgsd8.mp3", "apiSignature":"diuyd987d", "remainingDollarBalance":"49.3", "transcript":"Hi, how are you?", "apiKey":"kjhsd987sdkjhsdkjhsdkjhdsk", "success":"true", "fileUrl":"https://example.com/calljhgsd8.mp3" }

API Documentation - Hands On Guide

Transcribe Command API

Here's the definition of the POST HTTP request:

method: POST
url: This is our server's endpoint to receive your POST request:
https://speechlogger.com/api/transcribe
headers:
- key: Content-Type, value: application/json
- key: Origin, value: https://speechnotes.co/files/Or a different origin, as long as there's one
body: body is a string of json with the following fields:
- key: apiKey, value: CHANGE_WITH_YOUR_API_KEY
- key: apiSecret, value: CHANGE_WITH_YOUR_API_SECRET
- key: type, value: upload
- key: fileUrl, value: https://link.to.the.file.mp3
- key: fileName, value: CHANGE_WITH_YOUR_FILE_NAME
- key: language, value: en-USChange with the actual language of the recording. Format is BCP-47.
- key: api_custom, value: CHANGE_WITH_YOUR_DATA_STRINGUse this field to pass to the webhook data.
Here's a body example:
{ "apiKey": "CHANGE_WITH_YOUR_API_KEY", "apiSecret": "CHANGE_WITH_YOUR_API_SECRET", "type": "upload", "fileUrl": "https://ttsreader.com/actors/1005/sample2.mp3", "fileName": "File_d987cckjhd8_api", "language":"en-US", "api_custom": "CRM_clientId=kjhsd87ds987" }

Here's an example of such a POST made to Speechnotes' API:

Bash code:
curl -H "Content-Type: application/json" -H "Origin: https://speechnotes.co/files/" --data @upload.txt https://speechlogger.com/api/transcribe

Where as the file 'upload.txt' is in the folder where the command is executed and contains the following text:
{ "apiKey": "CHANGE_WITH_YOUR_API_KEY", "apiSecret": "CHANGE_WITH_YOUR_API_SECRET", "type": "upload", "fileUrl": "https://ttsreader.com/actors/1005/sample2.mp3", "fileName": "File_d987cckjhd8_api", "language":"en-US", "api_custom": "CRM_clientId=kjhsd87ds987" }

Ready to Start?

Get started on Speechnotes Files Transcription Service.

Need Help? Customization? Talk to Us

Shoot us an email to admin@speechlogger.com

API & Webhooks for Automating Your Transcriptions Work Flows