Versões comparadas

Chave

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

/sms/audio

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

...

DESCRIÇÃO

Com este método podemos enviar um arquivo MP3 para um ou para múltiplos números de telefone, fixos ou móveis.

ESTRUTURA DA URL

https://api.directcallsoft.com/sms/audio

VERSÃO

1

MÉTODO

POST

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
Bloco de código
{


   "api":"sms",


   "modulo":"recebimento",


   "status":"ok",


   "codigo":"000",


   "msg": "Audio Cadastrado com sucesso - AUDIO_ID: XXXXXXXXXXXXXXX",

 
   "audio_id": "XXXXXXXXXXXXXXXXXXXXXXXX"

}

Informações

Validade 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.

...