Passer au contenu principal
POST
/
api
/
optimus
/
phone-call
Passer un appel téléphonique
curl --request POST \
  --url https://api.example.com/api/optimus/phone-call

​
Requête

curl -X POST https://app.orova.ai/api/optimus/call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "AGENT_ID",
    "phoneNumber": "+1234567890",
    "phoneNumberId": "PHONE_NUMBER_ID",
    "contactName": "John Doe",
    "workspaceId": "WORKSPACE_ID"
  }'

​
Paramètres

ChampTypeRequisDescription
assistantIdstringOuiAgent à utiliser pour l’appel
phoneNumberstringOuiNuméro de téléphone de destination (E.164)
phoneNumberIdstringOuiNuméro Orova depuis lequel appeler
contactNamestringNonNom du contact pour l’historique et l’injection de variables
workspaceIdstringOuiID de l’espace de travail

​
Réponse

{
  "call_id": "call_abc123",
  "status": "initiated"
}

​
Remarques

  • Une vérification des crédits est effectuée avant l’appel. Renvoie 402 si les crédits sont insuffisants.
  • Si contactName est fourni, Orova recherche le contact et injecte ses données sous forme de variables.
  • L’appel est lancé via Twilio. L’agent prononce le premier message lorsque le destinataire répond.