Skip to main content
POST
/
assistants
/
create-telephony
cURL
curl --request POST \
  --url https://alto.dialme.at/api/altov2/public/assistants/create-telephony \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "template_id": "<string>",
  "name": "<string>",
  "voice": "en-US-Neural2-D",
  "phone_number": "<string>",
  "structured_data": [
    {
      "type": "short_response",
      "value": "<string>",
      "choices": [
        "<string>"
      ]
    }
  ],
  "webhook": "<string>"
}
'
{
  "message": "success",
  "result": {
    "_id": "as_***",
    "template_id": "tp_***",
    "title": "<string>",
    "conversational_states": {},
    "language": "<string>",
    "voice": "<string>",
    "phone_number": "<string>",
    "webhook": "<string>",
    "structured_data": [
      "<unknown>"
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Retrieve your key from Dashboard.

Body

application/json
​
template_id
string
required
Required string length: 24
​
name
string
required
Required string length: 3 - 180
​
voice
enum<string>
required
Available options:
en-US-Neural2-D,
en-US-Neural2-C,
en-US-Neural2-J,
en-US-News-K,
en-GB-News-M,
en-GB-Neural2-C,
en-GB-Neural2-B,
en-GB-Neural2-F,
es-ES-Neural2-B,
es-ES-Neural2-F,
es-ES-Neural2-C,
es-ES-Neural2-D,
en-US-Eleven-Marcus,
en-US-Eleven-Myra,
en-US-Eleven-Adam,
en-US-OpenAI-alloy,
en-US-OpenAI-echo,
en-GB-OpenAI-fable,
en-US-OpenAI-onyx,
en-US-OpenAI-nova,
en-US-OpenAI-shimmer,
es-ES-OpenAI-alloy,
es-ES-OpenAI-echo,
es-ES-OpenAI-onyx,
es-ES-OpenAI-nova,
es-ES-OpenAI-shimmer
​
phone_number
string
required
Required string length: 10 - 15
​
structured_data
object[]
​
webhook
string

We will trigger post request to this webhook url with this datan

{
  "data": {
    "conversation_type": "telephony",
    "conversation_id": "",
    "assistant_id": "",
    "full_transcript": [],
    "edited_transcript": [],
    "data_points": [],
    "from_phone": "",
    "to_phone": "",
    "timestamp": 0,
    "call_duration": ""
  },
  "signature": ""
}

We generated a signature to secure the webhook payload, please refer to the colab example.

Minimum string length: 5

Response

Successful response

​
message
string
Example:

"success"

​
result
object