Cascada de canales

El objeto channel determina por qué canales se envía el mensaje y en qué orden. Está disponible en Advanced transactional y Advanced promotional, solo en la versión 2.0 de la API.

Tabla de canales

Cada clave del objeto channel es un canal y contiene el objeto propio de ese canal.

CLAVE	OBJETO DEL CANAL
`sms`	SMS
`viber`	Viber – transaccional / Viber – promocional
`rcs`	RCS
`whatsapp`	WhatsApp

Orden de la cascada

El orden de las claves en su solicitud es el orden de la cascada. La primera clave es el canal principal; si el mensaje no se puede entregar por él, se utiliza el siguiente canal de la lista.

{ "channel": { "viber": { "sender": "BulkGate" }, "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } } }

Aquí se prueba primero Viber y después SMS. Si intercambia las dos claves, se intercambia la prioridad; nada más cambia en la solicitud.

Importante

El SMS no se añade automáticamente al final de la cascada. Si quiere el SMS como última alternativa, indique el objeto sms de forma explícita. Una cascada formada solo por {"viber": {…}} no tiene ninguna alternativa.

Si se omite por completo channel, el mensaje se envía como SMS con el remitente predeterminado.

Cambio entre canales - `expiration`

Cada objeto de canal tiene su propio expiration: el límite de tiempo en segundos tras el cual se utiliza el siguiente canal de la cascada. Los valores inferiores a 60 se ignoran y se sustituyen por el valor predeterminado de ese canal.

CANAL	`expiration` PREDETERMINADO
`viber`	`300`
`rcs`	`60`
`whatsapp`	`180`

Qué texto se utiliza

sms y viber buscan el texto en tres lugares; gana el primero que no esté vacío:

PRIORIDAD	LUGAR	NOTA
1	`number[].text`	texto de un destinatario concreto; consulte Valor `number`
2	`channel.sms.text` / `channel.viber.text`	texto para ese canal concreto
3	`text`	texto de nivel superior de la solicitud

rcs y whatsapp no leen ninguno de ellos. Su contenido está dentro de su propio objeto de variante (message, template, card, …), por lo que el text de nivel superior no les afecta.

Errores

TIPO	SIGNIFICADO
`invalid_rcs_variant`	el objeto `rcs` no contiene ninguno o contiene más de uno de `message`/`file`/`card`/`carousel`
`invalid_whatsapp_variant`	el objeto `whatsapp` no contiene ninguno o contiene más de uno de `template`/`otp`/`message`/`file`/`location`
`no_recipients`	la solicitud no generó ningún destinatario válido

Consulte todos los tipos de error de Simple API y Advanced API aquí.

¿Le ha resultado útil esta página?

Preguntar a la IA Copiado