Integra con SMSBlast.

Enviar un SMS

Envía un texto (o un MMS con imagen) desde un número verificado que posees a un destinatario o hasta 100 a la vez. Los destinatarios dados de baja se omiten automáticamente.

Endpoint

Encabezados

• Authorization: Bearer YOUR_API_KEY
• Content-Type: application/json

Cuerpo de la solicitud

• to Número de teléfono (cadena) o arreglo de números (máximo 100), en formato E.164.
• from Obligatorio. Tu número de teléfono verificado desde el que envías (formato E.164, p. ej. +18005551234).
• message Contenido del mensaje SMS (cadena). Admite {{firstName}} y otros marcadores, que se completan por destinatario desde su contacto.
• name (opcional) Nombre del contacto. Solo se aplica al enviar a un destinatario; establece y sobrescribe el nombre y apellido de ese contacto.
• mediaUrl (opcional) URL https pública de una imagen para enviar como MMS, adjunta a cada destinatario y cobrada a la tarifa de MMS. Las operadoras aceptan jpg, png, gif o webp de hasta 5MB.

curl -X POST https://app.smsblast.io/api/v2/sms/send -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"to":"+15551234567","from":"+18005551234","message":"Hello from SMSBlast API!","name":"Jane Doe"}'

const axios = require('axios');

axios.post('https://app.smsblast.io/api/v2/sms/send', {
  to: '+15551234567',
  from: '+18005551234',
  message: 'Hello from SMSBlast API!',
  name: 'Jane Doe'
}, {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

<?php
$apiKey = 'YOUR_API_KEY';
$url = 'https://app.smsblast.io/api/v2/sms/send';

$data = [
    'to' => '+15551234567',
    'from' => '+18005551234',
    'message' => 'Hello from SMSBlast API!',
    'name' => 'Jane Doe'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Respuesta

{
  "success": true,
  "sent": 1,
  "failed": 0,
  "totalCost": "0.0150",
  "results": [
    {
      "to": "+15551234567",
      "status": "sent",
      "messageSid": "SM...",
      "segments": 1,
      "cost": 0.015
    }
  ]
}

errors se incluye solo cuando algunos destinatarios no pudieron recibir el envío (por ejemplo, dados de baja), cada uno con un to y un motivo en error.

Respuestas de error

• 401 Clave de API ausente o inválida.
• 400 Campo "from" ausente, número no encontrado o no verificado, o cuerpo de solicitud inválido.
• 402 Saldo insuficiente.

Dar de baja un contacto

Evita que un contacto reciba más mensajes. Se identifica por número de teléfono dentro de tu cuenta. Idempotente.

Endpoint

Encabezados

• Authorization: Bearer YOUR_API_KEY
• Content-Type: application/json

Cuerpo de la solicitud

• number Obligatorio. El número de teléfono del contacto (E.164, p. ej. +15551234567).

curl -X POST https://app.smsblast.io/api/v2/contacts/opt-out -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"number":"+15551234567"}'

const axios = require('axios');

axios.post('https://app.smsblast.io/api/v2/contacts/opt-out', {
  number: '+15551234567'
}, {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

<?php
$apiKey = 'YOUR_API_KEY';
$ch = curl_init('https://app.smsblast.io/api/v2/contacts/opt-out');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['number' => '+15551234567']));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));

Respuesta

{
  "success": true,
  "optedOut": 1,
  "alreadyOptedOut": false,
  "number": "+15551234567"
}

Devuelve 404 si ningún contacto coincide con el número. alreadyOptedOut es true cuando el contacto ya estaba dado de baja.

Respuestas de error

• 401 Clave de API ausente o inválida.
• 400 Número ausente o inválido.
• 404 Ningún contacto de tu cuenta coincide con ese número.

Cuenta

Devuelve la información de tu cuenta, útil para confirmar que una clave de API funciona y revisar tu saldo y número remitente. Sin costo.

Endpoint

Encabezados

• Authorization: Bearer YOUR_API_KEY

curl https://app.smsblast.io/api/v2/me -H "Authorization: Bearer YOUR_API_KEY"

const axios = require('axios');

axios.get('https://app.smsblast.io/api/v2/me', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

<?php
$apiKey = 'YOUR_API_KEY';
$ch = curl_init('https://app.smsblast.io/api/v2/me');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $apiKey]);
$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));

Respuesta

{
  "id": "org_uuid",
  "name": "Acme Inc",
  "balance": 42.50,
  "sender_number": "+18885551234",
  "sender_status": "verified"
}

Respuestas de error

• 401 Clave de API ausente o inválida.