GET Speech to Text
The Messages API returns a list of all the messages in a conversation. You can use this for providing Speech to Text data (also known as transcription sometimes) for video conference, meeting or telephone call.
Here message refer to a continuous sentence spoken by a speaker.
Sentiment Analysis in messages BETA#
Here you can enable sentiment analysis over each message which is being spoken in the conversation.
All you need to do is pass sentiment=true as a query parameter. Read more about it.
HTTP Request#
GET https://api.symbl.ai/v1/conversations/{conversationId}/messages
Example API call#
- cURL
- Node.js
- Python
Query Params#
| Parameter | Required | Value | Description |
|---|---|---|---|
verbose | No | true | Gives you word level timestamps of each sentence. |
sentiment | No | true | Give you Sentiment Analysis on each message. |
Response#
Response Object#
| Field | Description |
|---|---|
id | Unique message identifier. |
text | Message text. |
from | User object with name and email. |
startTime | DateTime value. |
endTime | DateTime value. |
conversationId | Unique conversation identifier. |
words | Words object with properties word, startTime and endTime. |
phrases | It shows the most important action phrases in each sentence. It's enabled when you pass detectPhrases=true during submiting the request in Async and Websocket API. |
sentiment | Shows the sentiment polarity(intensity of negativity or positivity of a sentence) and suggested sentiment type (positive, negative and neutral). |