Personalities

Personality defines the manner and voice with which your agent will speak. These configurations are proprietary to Reecall, but you can list them so you can change them in different agents.

To retrieve the latter, we rely on the documentation api:

cURL

curl -X GET \
  -H "Authorization: Bearer <APIKEY>" \
  -H "Content-Type: application/json" \
  {{baseUrl}}/api/personalities

NodeJS

const axios = require('axios');

const baseUrl = "{{baseUrl}}/api/personalities";
const apiKey = "YOUR API KEY";
const headers = {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
};

axios.get(baseUrl, { headers: headers })
    .then(response => {
        console.log('Status Code:', response.status);
        console.log('Response Data:', response.data);
    })
    .catch(error => {
        console.error('Error:', error.response.status);
        console.error('Error Data:', error.response.data);
    });

If the query went well, you'll get a list of personalities in this format:

{
    "name": "string",
    "lang": "fr-FR",
    "provider": "string",
    "voice": "string",
    "gender": "string",
    "speed": "string",
    "status": "string",
    "pitch": "string",
    "audioUrl": "string"
}

You can also test the voices with editable text. To do this, you'll need to use the supplied audioUrl.

curl -X POST \
   -H "Authorization: Bearer <APIKEY>" \
   -H "Content-Type: application/json" \
   -d {"text": ""} \
   <audioUrl>

tip

If you want to allow your users to test each of the agent's phrases, consider including the personality when retrieving the agent with the following filters:

{
    "include": [{
        "relation": "personality",
        "scope": {
            "fields": ["audioUrl"]
        }
    }]
}