Usa HTTPS e l'autenticazione HTTP Basic con credenziali API approvate. Conserva le credenziali sul server della tua applicazione. Questi endpoint Hosted PBX usano /hpbx/ su api.multitel.net; non inserire /v3. Controlla sia il risultato HTTP sia lo stato applicativo nella risposta JSON.
Scegli il numero e il PBX
La forma dell'endpoint è POST /hpbx/dids/{operation}/{billing_code}. Le operazioni supportate includono creazione, modifica ed eliminazione. Il codice di fatturazione deve identificare un PBX appartenente all'account autenticato. Un record di instradamento non acquista un nuovo numero di telefono pubblico.
Campi di instradamento
| Campo | Scopo |
|---|---|
| number / fullnumber | Il DID rappresentato dal record di instradamento del PBX. |
| comment | Una descrizione rivolta agli amministratori. |
| maxchannels | Il numero massimo di chiamate simultanee della route PBX. |
| destination | Valori di destinazione ordinati per il PBX selezionato. |
| unconditional | Una destinazione di inoltro incondizionato, quando utilizzata. |
| cnam | Impostazione di ricerca del nome del chiamante; potrebbero applicarsi addebiti per l'utilizzo. |
| recording | Criterio di registrazione: no, yes, yeschange o nochange. |
| di_emailrecording / di_minemailrecording | Email di destinazione della registrazione e durata minima. |
| allowemergency / emergencynotes | Impostazioni dell'ID chiamante per le emergenze; non registrano un indirizzo di emergenza. |
| didprefix / didnameprefix | Prefissi numero/nome chiamante. |
| fax / faxprotocol / faxstore / faxemail | Rilevamento fax, protocollo e opzioni di consegna/archiviazione. |
| sms_destination / di_smstofield / di_sms_store | Impostazioni di recapito/archiviazione dei messaggi abilitate. |
Prepara destinazioni valide
I valori di destinazione devono provenire dal PBX selezionato; il precedente esempio Array() non era un payload JSON o di modulo. Risolvi interni, IVR o gruppi prima di costruire la richiesta. Usa lo schema corrente di instradamento dei numeri per l'interfaccia API con cui stai integrando.
Verifica il risultato
Controlla lo stato restituito dall'applicazione, riapri la configurazione del numero ed effettua una chiamata in entrata di prova controllata. Verifica separatamente i percorsi per occupato, mancata risposta, timeout e registrazione/fax/messaggio. Segui la guida all'instradamento del portale per una configurazione passo passo.