Utilize HTTPS e autenticação HTTP Basic com credenciais de API aprovadas. Mantenha as credenciais no servidor da sua aplicação. Estes endpoints do Hosted PBX utilizam /hpbx/ em api.multitel.net; não insira /v3. Verifique tanto o resultado HTTP como o estado da aplicação na resposta JSON.
Escolha o número e o PBX
A forma do endpoint é POST /hpbx/dids/{operation}/{billing_code}. As operações suportadas incluem criar, editar e eliminar. O código de faturação deve identificar um PBX pertencente à conta autenticada. Um registo de encaminhamento não adquire um novo número de telefone público.
Campos de encaminhamento
| Campo | Finalidade |
|---|---|
| number / fullnumber | O DID representado pelo registo de encaminhamento do PBX. |
| comment | Uma descrição destinada aos administradores. |
| maxchannels | O número máximo de chamadas simultâneas da rota PBX. |
| destination | Valores de destino ordenados para o PBX selecionado. |
| unconditional | Um destino de reencaminhamento incondicional, quando utilizado. |
| cnam | Configuração de pesquisa de nome do chamador; taxas de uso podem ser aplicadas. |
| recording | Política de gravação: no, yes, yeschange ou nochange. |
| di_emailrecording / di_minemailrecording | Email de destino da gravação e duração mínima. |
| allowemergency / emergencynotes | Definições de ID de chamador de emergência; estas não registam um endereço de emergência. |
| didprefix / didnameprefix | Prefixos de número/nome do chamador. |
| fax / faxprotocol / faxstore / faxemail | Detecção de fax, protocolo e opções de entrega/armazenamento. |
| sms_destination / di_smstofield / di_sms_store | Definições de entrega/armazenamento de mensagens ativadas. |
Prepare destinos válidos
Os valores de destino têm de provir do PBX selecionado; o antigo exemplo Array() não era uma carga JSON nem de formulário. Resolva as extensões, IVRs ou grupos antes de construir o pedido. Utilize o esquema atual de encaminhamento de números para a interface de API com a qual está a integrar a sua aplicação.
Verifique o resultado
Inspecione o status retornado pelo aplicativo, reabra a configuração do número e faça uma chamada de entrada controlada. Verifique separadamente os caminhos de ocupado, não atendimento, tempo limite e gravação/fax/mensagem. Siga o guia de roteamento do portal para uma configuração passo a passo.