PortSMS está en portsms.com. Tu dirección personal de recarga te espera en la página Saldo después de iniciar sesión.

PortSMS

Informes de entrega y webhooks

Qué significan queued, sent, delivered y failed, y cómo recibir los cambios de estado en tu servidor.

Actualizado el 2026-10-13

La vida de un mensaje

Después de enviar, cada destinatario queda en cola y se cobra (queued), y luego se pasa a una ruta del operador (sent). Más tarde el operador informa si el teléfono lo recibió (delivered) o no (failed).

Cuándo llegan los informes

La mayoría de los informes llegan en segundos o en pocos minutos. Algunos operadores informan tarde o nunca; un mensaje sin informe se queda en sent.

Reembolsos

Un mensaje fallido se reembolsa a tu saldo automáticamente. Puedes ver cada reembolso en el historial de tu saldo, con el id del mensaje.

Recibir webhooks

Añade una dirección https en la página Clave API. Cuando un mensaje se entrega o falla, enviamos por POST un cuerpo JSON con el id del mensaje, el número, el estado, el precio y tu ref. Responde con cualquier estado 2xx; de lo contrario, reintentamos hasta 8 veces durante unas dos horas.

Comprobar la firma

Cada webhook incluye X-PortSMS-Signature: t=<time>,v1=<hex>. Calcula el HMAC-SHA256 del texto t.body con tu secreto de firma y compáralo con v1. Rechaza las solicitudes con más de cinco minutos de antigüedad para que no se pueda reutilizar una solicitud antigua.