--- title: Optimizando las Tasas de Entrega de Mensajes: Análisis Técnico Profundo description: Domina técnicas para maximizar las tasas de entrega de mensajes en SMS, WhatsApp y Email. Incluye validación, selección de canal y monitoreo. date: 2025-01-05 author: Victor Villalobos locale: es source: https://www.zavu.dev/es/blog/message-delivery-optimization tags: Rendimiento, Optimización, Técnico --- # Optimizando las Tasas de Entrega de Mensajes: Análisis Técnico Profundo 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: ```typescript import 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`: ```typescript const { 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: ```typescript try { 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 } 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 = {} 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](/es/contact-us) o unete a nuestra [comúnidad de Discord](https://discord.gg/ZxE8DYkveh) para soporte y actualizaciones.