Skip to main content

Getting started with Telephony API

Telephony API provides a speech-to-text transcription and enable you to extract follow-ups, topics, action-items, and questions from conversations over the Zoom call.

1. Get a transcription of your Zoom call.#

This example uses the Symbl Javascript SDK to connect to a Zoom meeting and get a speech-to-text transcription of the call.

endpoint: {
type: "pstn",
phoneNumber: phoneNumber,
dtmf: dtmfSequence,
data: {
session: {
name: meetingName,
}).then((connection) => {
const connectionId = connection.connectionId;
console.log('connection', connection);
console.log("Successfully connected.", connectionId);
console.log("Calling into Zoom now, please wait.");
.catch((err) => {
console.error("Error while starting the connection", err);

For more details please checkout below mentioned links:

2. How to get speech-to-text transcription from your conversations#

After you run execute the code above you should receive a Conversation ID (conversationId) in the response. A Conversation ID is the key to receiving conversational insights from any conversation. As an example, here's a simple API call which grabs the speech-to-text transcription from the conversation.

Grab speech-to-text transcription#

Remember to replace the conversationId in the API call with the Conversation ID you get from the previous API call.

curl "{conversationId}/messages" \
-H "Authorization: Bearer $AUTH_TOKEN"

Example response#

"conversationId": "6690671572287488",
"jobId": "50c63f4f-8232-45d7-8ec5-5ad5d379f042"

3. Grabbing other conversational insights using Conversation API#

Here's more data you can grab with our Conversation API:

View conversation topics
Summary topics provide a quick overview of the key things that were talked about in the conversation.

View action items
An action item is a specific outcome recognized in the conversation that requires one or more people in the conversation to take a specific action, e.g. set up a meeting, share a file, complete a task, etc.

View follow-ups
This is a category of action items with a connotation to follow-up a request or a task like sending an email or making a phone call or booking an appointment or setting up a meeting.