---
title: "¿Cómo integrar el envío de SMS en mi aplicación con una API?"
description: "Cómo integrar el envío de SMS en su app con una API: credenciales, formato de números, codificación, webhooks, reintentos y qué revisar antes de producción."
canonical: "https://omnichannels.ai/es/answers/integrate-sms-api/"
language: "es"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# ¿Cómo integrar el envío de SMS en mi aplicación con una API?

Canonical: https://omnichannels.ai/es/answers/integrate-sms-api/
Language: es
Publisher: OmniChannels.ai by BroadNet Technologies

**Respuesta breve:** Para integrar el envío de SMS en una aplicación, llame a la API de SMS del proveedor desde su backend con un token de acceso, el número del destinatario en formato internacional, un ID de remitente (sender ID) aprobado y el texto. Guarde el ID de mensaje devuelto, reciba los estados de entrega en un webhook y gestione errores, reintentos y límites de frecuencia antes de pasar a producción.

## Pasos para la integración

1. Obtenga credenciales de prueba y registre los números de prueba a los que enviará.
2. Guarde el token de la API en un gestor de secretos o en una variable de entorno del servidor, nunca en una app móvil ni en código del navegador.
3. Guarde los números en formato E.164 y conviértalos al formato que espera la API.
4. Elija la codificación: texto GSM-7, o Unicode para árabe, emojis y otras escrituras.
5. Envíe el mensaje y guarde el ID devuelto junto a su propio registro.
6. Configure un webhook para recibir los estados de entrega.
7. Añada reintentos con espera progresiva para las respuestas 429 y 5xx, y registre ID de remitente en cada país que lo exija.

## Errores que conviene evitar

- Llamar a la API desde la app cliente, lo que expone el token a cualquiera.
- Enviar números con signo más, espacios o el cero inicial nacional cuando la API espera solo dígitos.
- Dejar que una comilla tipográfica o un emoji pase todo el mensaje a Unicode, lo que reduce los caracteres por segmento.
- Reintentar a ciegas tras un timeout. Si la API no tiene clave de idempotencia, registre antes cada envío y compruebe su estado antes de reenviar.
- Ignorar las respuestas 429 en lugar de esperar lo que indica la cabecera Retry-After.

## Ejemplo: petición de un SMS

En OmniChannels.ai se envía un SMS con POST https://api.broadnet.me/sms/sendSms, una cabecera Authorization: Bearer y un cuerpo JSON. Una llamada correcta devuelve 200 con el ID del mensaje en texto plano. El acceso de prueba se concede tras una breve solicitud y funciona con sus propios números verificados; no hay alta instantánea en autoservicio.

| Campo | Ejemplo | Nota |
|---|---|---|
| senderId | OmniDemo | Su ID de remitente aprobado |
| destinationNumber | 447700900123 | Prefijo del país más número, solo dígitos |
| message | Your code is 482913 | El texto |
| messageType | TEXT | TEXT para GSM-7, UNICODE para árabe y emojis |

## Fuentes oficiales

- [RFC 9110: HTTP Semantics (IETF)](https://datatracker.ietf.org/doc/html/rfc9110)
- [ITU-T Recommendation E.164 — The international public telecommunication numbering plan](https://www.itu.int/rec/T-REC-E.164)
- [3GPP TS 23.038 — Alphabets and language-specific information](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=745)

## Preguntas relacionadas

- https://omnichannels.ai/es/answers/smpp-vs-http-api/
- https://omnichannels.ai/es/answers/delivery-report-webhook/
- https://omnichannels.ai/es/answers/why-sms-split-into-parts/
- https://omnichannels.ai/es/answers/what-is-sender-id/
- https://omnichannels.ai/es/answers/send-whatsapp-message-api/

Actualizado: 2026-10-10