Iniciar sesión

Probar gratis

ID del mensaje (antes ID de SMS)

Cada mensaje enviado a través de BulkGate recibe su propio ID del mensaje. Es el único dato que nos permite localizar un mensaje concreto: en el portal, en la respuesta de la API y en el proveedor de entrega. Antes se llamaba ID de SMS; se trata del mismo valor, solo que entretanto cambió de nombre, porque hace tiempo que no enviamos únicamente SMS.

Qué es el ID del mensaje

El ID del mensaje es un identificador de texto de un mensaje enviado a un destinatario.

BulkGate lo asigna automáticamente en el momento en que acepta el mensaje. No puede elegirlo ni modificarlo después.
Corresponde a un mensaje para un número. El envío de una campaña a mil números genera mil valores de ID del mensaje distintos, no uno compartido.
Su forma varía según la interfaz a través de la que envíe. Trátelo como una cadena opaca: no deduzca de él la fecha, el canal ni ningún otro dato, y nunca intente construirlo usted mismo.

Consejo

Si necesita marcar los mensajes con un valor propio —un número de pedido, un ID de cliente—, para eso sirve la Etiqueta (TAG), no el ID del mensaje. La diferencia se describe en En qué se diferencia de los demás identificadores.

Por qué antes se llamaba ID de SMS

El nombre ID de SMS procede de la época en que BulkGate solo enviaba SMS. Hoy Viber, WhatsApp y RCS viajan por el mismo camino, por lo que el identificador se llama ID del mensaje, tanto en el portal como en las interfaces más recientes.

Sin embargo, las API más antiguas no cambiaron el nombre de su campo para no romper las integraciones existentes:

Dónde	Cómo se llama el campo
Portal	`ID del mensaje`
Simple API, Advanced API versión `1.0`	`sms_id`
Advanced API versión `2.0`, Integration API, contraseñas de un solo uso	`message_id`
Informe de entrega (webhook)	`smsID`

En todos los casos se trata del mismo valor. Así que, si toma el sms_id de una respuesta de la Simple API y lo busca en el historial en ID del mensaje, encontrará ese mismo mensaje.

Dónde encontrar el ID en el portal

En el menú, haga clic en Informes
Haga clic en Historia
Haga clic en la fila del mensaje: se despliega el detalle
El ID del mensaje está en la parte derecha del detalle; al hacer clic se selecciona el valor completo para que pueda copiarlo

También funciona a la inversa: si ya tiene el ID del mensaje y quiere encontrar el mensaje, abra Filtrar encima de la tabla y pegue el valor en el campo ID del mensaje. El mismo valor se incluye en la exportación del historial a CSV.

Qué muestra el historial y cómo filtrarlo se describe en Historial.

Importante

El texto del mensaje no se conserva en el historial para siempre: en los registros más antiguos aparece Este mensaje ha caducado. en su lugar. El ID del mensaje y los demás datos se mantienen.

Dónde encontrar el ID en la respuesta de la API

Las interfaces devuelven el ID del mensaje directamente en la respuesta a la solicitud de envío. Es el único momento en que lo obtiene de forma programática, así que guárdelo en ese paso.

Interfaz	Cómo se llama el campo
Simple API	`sms_id`
Advanced API `1.0`	`sms_id`
Advanced API `2.0`	`message_id`
Integration API	`message_id`
Contraseñas de un solo uso	`message_id`

Junto a él, todas devuelven también un array part_id, que se describe en Qué es part_id.

En el envío masivo, la respuesta contiene un array response con un registro independiente para cada destinatario. El ID del mensaje termina entonces con el número de orden del mensaje dentro del lote:

{ "data": { "response": [ { "status": "accepted", "message_id": "transactional-64afe5f28ffc2-0", "part_id": ["transactional-64afe5f28ffc2-0"], "number": "420777777777", "channel": "sms" }, { "status": "accepted", "message_id": "transactional-64afe5f28ffc2-1", "part_id": ["transactional-64afe5f28ffc2-1"], "number": "420777777778", "channel": "sms" } ] } }

Qué es part_id

Un SMS largo no se entrega a la red del operador de una sola pieza: se divide en varios mensajes independientes que el teléfono del destinatario vuelve a unir. Cada una de esas partes tiene su propio ID, y part_id es la lista de ellos. Cuándo y por qué se divide un mensaje se describe en Concatenación de mensajes.

El array sigue tres reglas:

El último elemento coincide siempre con el ID del mensaje: no lleva ningún sufijo.
Las partes anteriores llevan el sufijo _1, _2, etc., en el orden en que se compone el mensaje.
Un mensaje que no se ha dividido tiene un único elemento en part_id, idéntico al ID del mensaje. Esto incluye todos los SMS de una sola parte y todos los mensajes de Viber, WhatsApp y RCS, que nunca se dividen en partes.

Así, la respuesta para un SMS dividido en tres partes tiene este aspecto:

{ "data": { "status": "accepted", "sms_id": "tmpde1bcd4b1d1", "part_id": [ "tmpde1bcd4b1d1_1", "tmpde1bcd4b1d1_2", "tmpde1bcd4b1d1" ], "number": "420777777777" } }

Importante

Cada parte se factura como un SMS independiente. El número de elementos de part_id es, por tanto, también el número de mensajes que paga: tres en el ejemplo anterior, aunque haya enviado uno.

Consejo

Para emparejar respuestas e informes de entrega basta con el ID del mensaje. El part_id resulta útil cuando quiere saber ya en el momento del envío en cuántas partes se ha dividido el mensaje, sin esperar a que aparezca en el historial.

Dónde encontrar el ID en un webhook

El informe de entrega llega a la dirección que haya configurado, y el ID del mensaje está en su parámetro smsID. Utilícelo para emparejar el informe con el mensaje que envió.

De forma individual, la solicitud llega mediante GET con los valores en la query string; consulte Informe de entrega.
De forma masiva, llega una única solicitud POST con un array de registros en JSON; consulte Informe de entrega masivo.

Dónde se configura la dirección para los informes de entrega se describe en Webhooks.

Nota

Un mismo mensaje puede generar varios informes con el mismo smsID: el estado 2 significa que el mensaje está en cola en el operador y que el resultado llegará más tarde. Cuente con ver el mismo valor más de una vez.

Advertencia

Los mensajes entrantes y las respuestas, que reconocerá por status con el valor 10, no llevan el parámetro smsID. No son un informe de un mensaje que usted haya enviado, sino un mensaje nuevo del destinatario.

Para qué sirve el ID del mensaje

Notificar un problema de entrega. Sin el ID del mensaje no podemos localizar un mensaje concreto en el proveedor de entrega. El procedimiento completo se describe en El mensaje no se ha entregado; a una notificación puede adjuntar hasta tres valores de ID del mensaje distintos.
Emparejamiento en su propio sistema. Guarde el ID del mensaje de la respuesta de la API junto al pedido o al cliente, y asigne a ellos los informes de entrega entrantes según el parámetro smsID.
Buscar un mensaje en el historial. El ID del mensaje es el único filtro que lleva exactamente a un mensaje; por número o por campaña encontrará varios.

En qué se diferencia de los demás identificadores

El detalle del mensaje en el historial muestra, junto al ID del mensaje, otros identificadores. Es fácil confundirlos, pero cada uno responde a una pregunta distinta:

Identificador	Qué identifica	Quién lo asigna
`ID del mensaje`	Un mensaje para un destinatario	BulkGate
`ID de campaña`	Toda una campaña, es decir, todos los mensajes enviados juntos	BulkGate
`Etiqueta (TAG)`	Cualquier cosa que marque usted mismo: un pedido, un cliente, una ejecución de un script	Usted
`Application ID`	La aplicación desde la que se envió el mensaje	BulkGate

Consejo

La Etiqueta (TAG) es la única de ellos que asigna usted mismo. Si la rellena al enviar, podrá filtrar después el historial por ella sin conocer ningún ID del mensaje; resulta práctico cuando necesita encontrar todos los mensajes de un mismo pedido.

¿Le ha resultado útil esta página?

Preguntar a la IA Copiado