Composto API

POST /composto

Este método permite enviar uma ou mais mensagens a um destinatário, essa mensagem pode ser um: áudio, TTS ou uma transferência de uma chamada. A função recebe dois parâmetros obrigatórios (número destino e um array de dados) e um parâmetro opcional (bina). O formato dos campos funcionam da seguinte forma:numero_destino:

-> numero_destino: é um número DDD+TELEFONE. Ex.: “11998762345”

-> dados: é um array de objetos que possui a seguinte estrutura:

[  
 {  
    "acao":"ALGUMA AÇÃO",
    "acao_dados":{ARRAY_ACAO_DADOS}
 }
]

Este array pode ser criado da seguinte forma:

-> TTS

[
 {  
    "acao":"tts",
    "acao_dados":{  
       "mensagem":"Olá, como vai?",
       "velocidade":-6,
       "resposta_usuario":false
    }
 }
]

-> Áudio

[  
{  
    "acao":"audio",
    "acao_dados":{  
       "url_audio":"url_do_audio",
       "resposta_usuario":false
    }
 }
]

-> Transferir

[  
 {  
     "acao":"transferir",
     "acao_dados":{  
       "numero_telefone":"4800000000"
       "bina: "481111111111"
     }
 }

-> bina: é um número DDD+TELEFONE que o usuário deseja que apareça na chamada para o número destino. Ex.: “11995583299”.

Exemplo completo

 require_once "TotalVoiceAPI.class.php";
//Neste array montado enviaremos ao número destino um áudio que após finalizado a chamada será transferida a um número de telefone.
$dados=json_decode('[{"acao":"audio","acao_dados":{"url_audio":"https://incompetech.com/music/royalty-free/mp3-royaltyfree/Discovery%20Hit.mp3","resposta_usuario":false}},{"acao":"transferir","acao_dados":
{"numero_telefone":"4832830151"}}]');
$api = new TotalVoiceAPI("SEU_ACCESS_TOKEN");
$api->debugOn();
$api->enviaComposto("TELEFONE_DESTINO", $dados, "NUMERO_BINA");