Webhook de SMS - Short Message Service - Centro de documentación de Alibaba Cloud

Especifique una URL de callback para recibir los acuses de recibo de entrega desde el servidor HTTP. Al configurar esta URL, se asegura de obtener información oportuna y precisa sobre el estado de sus mensajes SMS.

Importante

No se garantiza que los acuses de recibo de entrega sean idempotentes. Tome las medidas adecuadas para asegurar la correcta integridad y consistencia de los datos.

Protocolo

Parámetro	Descripción
Protocolo	HTTP + JSON
Codificación	UTF-8

Parámetros de solicitud

Los datos de una solicitud POST utilizan el formato JSON Array. Es posible enviar varios acuses de recibo de entrega al servidor HTTP de forma simultánea.

Parámetro	Tipo	Ejemplo	Descripción
To	String	8521234****	Número de celular que recibe los acuses de recibo de entrega.
Status	String	1	Estado del mensaje. 1: El mensaje se envió. 2: El envío del mensaje presentó errores. 6: El mensaje expiró.
MessageId	String	123456789****	Identificador del acuse de recibo de entrega.
SmsSize	String	1	Cantidad de mensajes. Un mensaje largo se divide en varios mensajes.
TaskId	String	123456	Identificador de la tarea.
SendDate	String	Thu, 25 Nov 2021 10:27:00 +0800	Hora en la que se envió el mensaje al operador.
ReceiveDate	String	Thu, 25 Nov 2021 10:27:33 +0800	Hora en la que se recibió el acuse de recibo de entrega del operador.
ErrorCode	String	success	Código de error.
ErrorDescription	String	success	Mensaje de error.

Ejemplo

[{
    "To" : "8521111****",
    "SendDate" : "Thu, 25 Nov 2021 10:25:00 +0800",
    "ReceiveDate" : "Thu, 25 Nov 2021 10:25:33 +0800",
    "Status" : "1",
    "ErrorCode" : "success",
    "ErrorDescription" : "success",
    "TaskId" : "67890",
    "SmsSize":"2",
    "MessageId" : "123450000****"
  }]

Parámetros de respuesta

Cuando un acuse de recibo de entrega se envía a su servidor HTTP, el sistema devuelve el código 200. De lo contrario, intenta reenviarlo.

Ejemplo de respuesta

{
  "code" : 0,
  "msg" : "The message is received."
}

Parámetros de respuesta

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

code

Number

Sí

0

Código de la respuesta.

msg

String

No

Received

Mensaje de error.

Reintentos

Si el envío de un acuse de recibo de entrega presenta errores, el sistema vuelve a intentarlo después de 1 o 5 minutos hasta lograrlo. Tras tres fallos consecutivos, detiene los intentos de envío.

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
code	Number	Sí	0	Código de la respuesta.
msg	String	No	Received	Mensaje de error.