Skip to content
Inicio » API SMS Octopush » API SMS de Voz » Envio SMS de Voz

Envio SMS de Voz

POST
https://api.octopush.com/v1/public/voice-campaign/send

Codificación : UTF-8

Autentificación

Los identificadores “api-key” y “api-login” deben añadirse en las cabeceras.

Definición

Esto envía un SMS de Voz en modos:

  • simple (1 contacto)
  • campaign (hasta 500 contacts)

Debe indicar sus números de teléfono en el parámetro “destinatarios”, que es un array que contiene objetos de tipo “contacto”.

Parámetros especiales

NombreTypeDescripcion
textstringTexto del mensaje (de 1 a 1224 caracteres no unicode).
recipientsarrayLista de objetos de contacto array de objetos:
[
  {
    "phone_number": "+111222233334444"
  },
  ...,
  {
    "phone_number": "+2222333334444555"
  }
]
senderstringEmisor del mensaje (si el usuario lo permite), 3-11 caracteres alfanuméricos (a-zA-Z0-9).
send_atstring‘Cuando quieras enviar la campaña de sms. Formato: DateTime ISO8601 (ej: “2018-10-03T07:42:39-07:00”).’
purposestringPropósito de la campaña (transaccional/alerta o marketing) : [“alert”,”wholesale”]
voice_genderstringGenero de la voz [‘male’, ‘female’]. Here is availability of gender for each available country (F for female, M for male : ‘pl-PL’ => [F, M], ‘sv-SE’ => [F], ‘de-DE’ => [F, M], ‘en-GB’ => [F, M], ‘en-US’ => [F, M], ‘es-ES’ => [F, M], ‘fr-FR’ => [F, M], ‘it-IT’ => [F, M], ‘pt-BR’ => [F, M], ‘ru-RU’ => [F, M], ‘arb’ => [F], ‘ca-ES’ => [F], ‘zh-HK’ => [F, M], ‘mn-CN’ => [F], ‘da-DK’ => [F, M], ‘nl-NL’ => [F, M], ‘en-AU’ => [F, M], ‘en-IN’ => [F], ‘en-NZ’ => [F], ‘en-ZA’ => [F], ‘il-PH’ => [F, M], ‘fr-CA’ => [F, M], ‘de-AT’ => [F], ‘hi-IN’ => [F], ‘is-IS’ => [F, M], ‘id-ID’ => [F, M], ‘ja-JP’ => [F, M], ‘ko-KR’ => [F], ‘ms-MY’ => [F, M], ‘nb-NO’ => [F], ‘pt-PT’ => [F, M], ‘ro-RO’ => [F], ‘es-MX’ => [F], ‘es-US’ => [F, M], ‘th-TH’ => [F, M], ‘tr-TR’ => [F], ‘uz-UZ’ => [F, M], ‘vi-VN’ => [F, M], ‘cy-GB’ => [F])
voice_languagestringIdioma de la voz. Possibles valores : [‘en-US’, ‘en-GB’, ‘pl-PL’, ‘sv-SE’, ‘de-DE’, ‘es-ES’, ‘fr-FR’, ‘it-IT’, ‘pt-BR’, ‘ru-RU’, ‘arb’, ‘ca-ES’, ‘zh-HK’, ‘mn-CN’, ‘da-DK’, ‘nl-NL’, ‘en-AU’, ‘en-IN’, ‘en-NZ’, ‘en-ZA’, ‘il-PH’, ‘fr-CA’, ‘de-AT’, ‘hi-IN’, ‘is-IS’, ‘id-ID’, ‘ja-JP’, ‘ko-KR’, ‘ms-MY’, ‘nb-NO’, ‘pt-PT’, ‘ro-RO’, ‘es-MX’, ‘es-US’, ‘th-TH’, ‘tr-TR’, ‘uz-UZ’, ‘vi-VN’, ‘cy-GB’]
simulation_modeboolean(opcional) Si este valor es “true”, su petición será simulada y recibirá un resultado falso. Sólo se ejecutarán algunas validaciones mínimas.
request_idstring(optional) Para evitar enviar la misma solicitud varias veces, configure un ID de solicitud. En caso de que se detecte la duplicación, se devolverá un error de validación. El request_id expira luego de 24 horas.
get_back_pressed_keysboolean(opcional) Si este campo tiene el valor “true”, su llamada de voz permitirá a su destinatario usar el teclado de su teléfono. Después de 2 segundos, la llamada terminará (6 teclas como máximo)

Ejemplo Curl

curl -X POST \ 
'https://api.octopush.com/v1/public/voice-campaign/send' \ 
-H 'Content-Type: application/json' \ 
-H 'api-key: ******' \ 
-H 'api-login: *****@email.org' \ 
-H 'cache-control: no-cache' \ 
-d '{
  "recipients": 
  [
    {
      "phone_number": "+37379967255"
    }
  ],
  "text": "Tienes un SMS de Voz para escuchar",
  "purpose": "alert",
  "sender": "12345",
  "voice_gender": "female",
  "voice_language": "es-ES"
 }'

Respuesta Servidor en JSON

Éxito : 201 CREATED

{
  "ticket_number": "voice_5f44ebf9e47b7",
  "number_of_contacts": 1,
  "total_cost": 0.05,
  "estimated_duration": 30,
  "residual_credit": 149.95
}

Error : 400 Bad Request

{
   "code": 400,
   "message": "Payload validation error.",
   "errors":
   {
      "voice_language": 
      {
         "code": 442,
         "message": "Voice language not supported."
      }
   }
}