Skip to main content

​
POST /v1/call/originate

Origina una chiamata (click-to-call): il centralino chiama prima l’interno specificato, poi collega la chiamata al numero di destinazione.

​
Request Body

CampoTipoObbligatorioDescrizione
extensionstring✅Interno che effettua la chiamata
numberstring✅Numero da chiamare
descriptionstring❌Descrizione caller ID

​
Richiesta

curl -X POST https://api.mycentralino.com/v1/call/originate \
  -H "X-API-KEY: sk_mycentralino_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "extension": "201",
    "number": "3331234567",
    "description": "Cliente importante"
  }'

​
Risposta Successo

{
  "success": true,
  "message": "Chiamata originata con successo",
  "data": {
    "call_id": "call_65f3a2b1c4e5f6.12345678",
    "extension": "201",
    "number": "3331234567",
    "channel": "PJSIP/201",
    "timestamp": "2024-03-15 14:32:10"
  }
}

​
Errori

​
400 - Parametri mancanti

{
  "success": false,
  "error": "Parametri mancanti: extension e number sono obbligatori"
}

​
400 - Numero non valido

{
  "success": false,
  "error": "Numero di telefono non valido"
}

​
404 - Interno non trovato

{
  "success": false,
  "error": "Interno non trovato o non autorizzato"
}

​
503 - Errore connessione

{
  "success": false,
  "error": "Connessione AMI fallita: Connection refused"
}

​
Note

  • L’interno deve essere registrato per ricevere la chiamata
  • Il numero viene automaticamente pulito dai caratteri non numerici
  • Se description è vuoto, viene cercato automaticamente nel CRM
  • La chiamata è asincrona: la risposta arriva subito, la chiamata parte in background