Este método permite enviar SMS para telefones móveis e Mensagem de Voz para telefones fixos (opcional).

• O texto é automaticamente transformado em áudio antes de ser entregue, quando a opção de Mensagem de Voz é habilitada.

listar todos os números disponíveis para contratação

origem obrigatório Número de quem está enviando o SMS, formato exemplo: 554199990001 (DDI DDD NUMERO)

destino obrigatório Número de destino do SMS, formato exemplo: 551199990002 (DDI DDD NUMERO)

Notas sobre este parâmetro:

• Para enviar para mais do que um destinatário basta incluir um ; no meio de cada número, por exemplo: 554199990002;554199990003, mas esta alternativa não deve ser utilizada para enviar SMS para mais do que 10 destinatários.
• Quando você precisar enviar para mais do que 10 destinatários prefira informar os números via arquivo csv +Inf.
• Para números internacionais acrescente 00 na frente do numero. Ex.: 0011234567890
  

texto obrigatório Texto a ser enviado na mensagem pode ter até 700 caracteres, mas "importante":

Notas sobre este parâmetro:

• Cada SMS pode ter no máximo 140 caracteres, sendo contabilizado parâmetro texto mais parâmetro origem;
• Mensagens maiores serão divididas em "múltiplos SMS" e chegarão com complemento similar a 1/2, 2/2, etc.;
• A cobrança será proporcional ao número de SMS utilizado em cada envio.  

cron opcional Em caso de envio agendado, esta variável deve ser enviada no formato <dia-mes-ano-hora-minuto-segundo> "d-m-Y-H-i-s"

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

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

shortnum_number opcional para envio "com short number" Configure n para enviar o SMS sem short number ou s para enviar o SMS com short number.vip opcional Filtro de número PREMIUM ou COMUM (se omitido será listado ambos).

   1 - COMUM
   2 - PREMIUM

ddd opcional Filtro de número por DDD. exemplo 41

cidade opcional Filtro de número por CIDADE. exemplo Curitiba

tipo opcional Tipo de filtro. Se omitido, listará todos os serviços:

   29 - Linha Telefônica Virtual - BR (DID)
   40 - 0800IP A
   43 - Número Único Nacional (NUN)

pagina opcional Número da página (se omitido será mostrada a primeira página)

itens_por_pagina opcional Número de itens listados na página (se omitido será mostrado 10 itens)

_{IMPORTANTE: Se este parâmetro não for informado ou se for informado algo diferente de n (minúsculo), as mensagens serão enviadas "COM SHORT NUMBER", por padrão.}

• _{SMS COM SHORT NUMBER tem "custo maior" do que SMS SEM SHORT NUMBER, mas é um serviço mais confiável uma vez que é direto com as operadoras móveis, sem envolver chips de celulares. Além disso, o destinatário verá sempre o mesmo número de remetente (short number), o que pode estabelecer uma identidade para o seu negócio.}
• _{SMS SEM SHORT NUMBER tem "custo menor" do que SMS COM SHORT NUMBER, mas é um serviço menos confiável uma vez que utiliza chips de celulares. Além disso, o destinatário verá sempre um número de remetente "aleatório".}

1. RETORNO

msg Texto de resposta da API

callerid Código identificador da mensagem

id_mensagem: Identificador único para a mensagem

{

   "api":

"

numero",
   

"modulo":

"

numero",
   

"status":

"ok",
   

"codigo":

"000",

   "

data":[
 

{
 

    "

id_num":

"19179",
        

"cd_area":

"

41",

"

nr_

tel":

"35145100",

"

nome_cidade":

"

CURITIBA"

}

],
   

"pagina_atual":1,
   "

itens_por_pagina":

10,
   

"total_de_paginas":1,
   

"total_de_registros":1
}