API para Desarrolladores

Si tienes un ERP, CRM o tienda en línea (como Shopify o WooCommerce), puedes conectar tus sistemas directamente a IngeniaSMS para enviar notificaciones automáticas (ej. "Tu pedido ha sido enviado").

Generar un Token de API

Ve a la sección Desarrolladores & API en el menú izquierdo. Haz clic en "Generar Nueva API Key".

Atención: Esta llave secreta funciona como dinero en efectivo. Quien tenga esta llave podrá consumir tus tokens. ¡No la compartas ni la subas a GitHub!

Ejemplo de Envío (cURL)

Endpoint: POST https://ingeniasms.com/api/v1/messages/send

curl -X POST https://ingeniasms.com/api/v1/messages/send \
  -H "Authorization: Bearer TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "525512345678",
    "message": "Hola, tu código de verificación es 1234.",
    "isFlash": false
  }'

Códigos de Respuesta

  • 200 OK: Mensaje encolado exitosamente. Se descontaron los tokens.
  • 401 Unauthorized: API Key inválida.
  • 402 Payment Required: No tienes saldo suficiente en tu billetera.
  • 422 Unprocessable Entity: Número telefónico mal formateado.