API & Webhooks for Automating Your Transcriptions Workflow



Intro - Speechnotes' API Bottom Line

What can it do?

With Speechnotes' API you can achieve mainly 2 tasks:

  1. Automatically upload transcription tasks via code - REST API Post request or automatically no-code via Zapier, instead of manually uploading recordings. You can set a few parameters, including:
    • Language
    • Number of speakers
    • You can choose to transcribe only a part of the recording - by setting start and end points.
  2. Receive transcription results to your server via webhook or a Zapier workflow when results are ready.

Example use cases

With Speechnotes' API many people achieve the following:

Setting it up

Purchasing pre-paid minutes packages, generating your API credentials and related settings are all done through the regular dashboard once signed in to https://speechnotes.co/files/


Interested in learning more on the API & automatic transcription workflows? Keep reading.





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 workflows.



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 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).


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.



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:





API Documentation - Hands On Guide

Transcribe Command API

Here's the definition of the POST HTTP request:


Transcribe API - Complete CURL Code

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", "numSpeakers": "1", "fromSeconds": "60", "toSeconds": "1520" }

Transcribe API - Complete PHP Code

<?php
$data = array(
'apiKey' => 'CHANGE_WITH_YOUR_API_KEY',
'apiSecret' => 'CHANGE_WITH_YOUR_API_SECRET',
'type' => 'upload',
'fileName' => 'File_d987cckjhd8_api',
'language' => 'en-US',
'numSpeakers' => '2',
'api_custom' => 'CRM_clientId=kjhsd87ds987'
);

$postdata = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json','Origin: https://speechnotes.co'));

$result = curl_exec($ch);
curl_close($ch);
print_r ($result);
?>


Ready to Start?

Get started on Speechnotes Files Transcription Service.




Need Help? Customization? Talk to Us

Shoot us an email to admin@speechlogger.com