Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

/sms/audio

Este método permite enviar um arquivo de áudio a partir da API de Mensagem de Voz da Directcall.

...



DESCRIÇÃOCom este método podemos enviar um arquivo MP3 para um ou para múltiplos números de telefone, fixos ou móveis.
ESTRUTURA DA URLhttps://api.directcallsoft.com/sms/audio
VERSÃO1
MÉTODOPOST
PARÂMETROS

access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui

audio obrigatório Arquivo no formato MP3 de até 4mb

Notas sobre este parâmetro:  

  • Recomendamos o uso de mensagens de áudio curtas, com menos de 60s. 
  • Mensagens maiores costumam ter baixa audiência, os destinatários desligam antes de terminar.
  • Recomendamos ainda que seja utilizado um áudio de qualidade, produzido por algum estúdio de gravação. Isso costuma aumentar a audiência completa das mensagens.

format opcional Opção de retorno da API podendo ser JSON ou XML, se não informado JSON será o padrão

RETORNO

api Origem API que esta sendo usada

modulo Módulo que está sendo chamado

status Mensagem de status

codigo Código de retorno - Clique aqui para listar os códigos e suas descrições

msg Mensagem de texto do retorno

audio_id ID do áudio usado para envio de torpedos de voz
 

Exemplo de resposta em JSON

{
   "api":"sms",
   "modulo":"recebimento",
   "status":"ok",
   "codigo":"000",
   "msg": "Audio Cadastrado com sucesso - AUDIO_ID: XXXXXXXXXXXXXXX",
"
audio_id": "XXXXXXXXXXXXXXXXXXXXXXXX"

}




Informações
titleValidade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisação de novos tokens.


...