Lograr altas tasas de entrega de mensajes requiere entender los matices técnicos de cada canal. En esta guía, exploraremos estrategias avanzadas de optimización utilizadas con Zavu para maximizar la entregabilidad.
Entendiendo los Desafios de Entrega
La entrega de mensajes puede fallar por varias razones:
- Números de teléfono inválidos - Números que no existen o estan formateados incorrectamente
- Filtrado de operadores - Mensajes bloqueados por filtros de spam de operadores
- Indisponibilidad del canal - WhatsApp no instalado, teléfono apagado, etc.
- Límites de tasa - Exceder los límites del operador o la plataforma
- Problemas de contenido - Disparadores de spam o violaciones de políticas
Validación de Números de Teléfono
Valida los números de teléfono antes de enviar:
TypeScriptimport Zavudev from '@zavudev/sdk' const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY }) async function validateAndSend(phoneNumber: string) { // POST /v1/introspect/phone const validation = await zavu.introspect.validatePhone({ phoneNumber }) if (!validation.validNumber) { console.error('Invalid number:', phoneNumber) return } // Get detailed information console.log({ phoneNumber: validation.phoneNumber, // E.164 format countryCode: validation.countryCode, // US, GB, etc. nationalFormat: validation.nationalFormat, // (312) 945-7420 carrier: validation.carrier?.name, // carrier name, when known lineType: validation.lineType, // mobile, landline, voip, toll_free, unknown availableChannels: validation.availableChannels }) // Only send to valid mobile numbers if (validation.lineType === 'mobile') { await zavu.messages.send({ to: validation.phoneNumber, text: 'Your verification code is 123456' }) } }
Selección de Canal
Con channel: 'auto' (el valor por defecto cuando omites channel), Zavu elige el canal según lo que el sender puede enviar y el tipo de destinatario:
TypeScript// Let Zavu choose the channel const { message } = await zavu.messages.send({ to: '+1234567890', channel: 'auto', text: 'Your package is out for delivery!' }) console.log('Selected channel:', message.channel) console.log('Status:', message.status) // queued, then sent / delivered / failed
Implementando Fallback
Un mensaje de texto o plantilla de WhatsApp que falla puede reintentarse por SMS, si el sender también tiene SMS. Está activado por defecto con channel: 'auto', y desactivado cuando fijas un canal explícito, salvo que pases fallbackEnabled: true:
TypeScriptconst { message } = await zavu.messages.send({ to: '+1234567890', channel: 'whatsapp', text: 'Important: Your appointment is tomorrow at 2 PM', fallbackEnabled: true // retry over SMS if the WhatsApp send fails }) // Follow the outcome with GET /v1/messages/{messageId} or the message.* webhooks const latest = await zavu.messages.retrieve(message.id) console.log(latest.message.channel, latest.message.status, latest.message.errorCode)
Los medios, botones, listas y otros tipos exclusivos de WhatsApp nunca hacen fallback. El email no forma parte del fallback: envíalo como un mensaje aparte si lo necesitas.
Optimización de Contenido
Evita los filtros de spam: nada de mayúsculas sostenidas, ni cadenas de signos de exclamación, ni acortadores de URL, y nombra tu negocio en el mensaje. Zavu revisa cada SMS antes de enviarlo, y un mensaje que la revisión rechaza recibe 422 sms_compliance_blocked, que te dice qué corregir:
TypeScripttry { await zavu.messages.send({ to: '+1234567890', channel: 'sms', text: 'URGENT!!! Click here to claim your FREE prize NOW!!!' }) } catch (err) { if (err instanceof Zavudev.UnprocessableEntityError) { // { code: 'sms_compliance_blocked', message, details: { riskScore, complianceFailures, requiredFixes, suggestedCompliantVersion? } } const body = err.error as { code?: string; details?: Record<string, unknown> } console.log('Blocked:', body.code) console.log('Required fixes:', body.details?.requiredFixes) console.log('Suggested rewrite:', body.details?.suggestedCompliantVersion) } else { throw err } }
Las URLs en SMS también deben estar verificadas: envíalas por adelantado con POST /v1/urls.
Monitoreo de Entregas
Las métricas de entrega están en el dashboard, en Monitoring. Para calcular las tuyas, lista los mensajes y cuenta por estado:
TypeScript// Count recent outbound SMS by status const counts: Record<string, number> = {} for await (const message of zavu.messages.list({ channel: 'sms', limit: 100 })) { if (message.direction !== 'outbound') continue counts[message.status] = (counts[message.status] ?? 0) + 1 } const sent = Object.values(counts).reduce((a, b) => a + b, 0) console.log(counts) // { delivered: 4850, failed: 150, ... } console.log('Delivery rate:', (counts.delivered ?? 0) / sent)
Para seguimiento en tiempo real, suscribe el webhook de tu sender a message.delivered y message.failed.
Qué Medir
Mide esto antes y después de cada cambio:
| Métrica | Cómo medirla |
|---|---|
| Tasa de entrega SMS | delivered / SMS salientes, desde GET /v1/messages |
| Tasa de entrega WhatsApp | delivered + read / WhatsApp salientes |
| Motivos de fallo | errorCode en los mensajes fallidos |
| Costo por mensaje | costTotal en cada mensaje |
Conclusion
Optimizar la entrega de mensajes es un proceso continuo. Usa la pantalla Monitoring del dashboard y los webhooks de mensajes para seguir de cerca tus tasas de entrega.
Necesitas ayuda optimizando tu entrega de mensajes? Contáctaños o unete a nuestra comúnidad de Discord para soporte y actualizaciones.