--- title: Guía Completa de Integración con WhatsApp Business API description: Todo lo que necesitas saber sobre la integración de WhatsApp Business API con Zavu para mensajería empresarial. date: 2025-01-10 author: Jennifer Villalobos locale: es source: https://www.zavu.dev/es/blog/whatsapp-business-api-integration tags: WhatsApp, Integración, Empresarial --- # Guía Completa de Integración con WhatsApp Business API WhatsApp Business API permite a las empresas comunicarse con clientes a escala. Con Zavu, puedes integrar WhatsApp junto con otros canales a través de una sola API unificada. ## Por qué WhatsApp Business API? WhatsApp tiene más de 2 mil millones de usuarios activos en todo el mundo, lo que lo convierte en uno de los canales más efectivos para la comunicación con clientes: - **98% de tasa de apertura** comparado con 20% del email - **Soporte de medios enriquecidos** incluyendo imágenes, documentos y botones interactivos - **Cifrado de extremo a extremo** para comunicaciones seguras - **Alcance global** con presencia en más de 180 países ## Configurando WhatsApp con Zavu ### Paso 1: Conecta tu cuenta de WhatsApp Business Conecta tu número desde el dashboard, en **Channels** > **WhatsApp**. El flujo de registro de Meta vincula tu WhatsApp Business Account (la verificación de la empresa ocurre del lado de Meta) y el número queda asociado a un sender. Después revisa el sender por la API: ```typescript import Zavudev from '@zavudev/sdk' const zavu = new Zavudev({ apiKey: process.env.ZAVUDEV_API_KEY }) // Revisa qué puede hacer el sender const sender = await zavu.senders.retrieve('sender_abc123') console.log('WhatsApp number:', sender.whatsapp?.displayPhoneNumber) console.log('Can send templates:', sender.whatsapp?.paymentStatus?.canSendTemplates) console.log('Active channels:', sender.channels) // incluye 'whatsapp' una vez activado ``` ### Paso 2: Configurar plantillas de mensajes WhatsApp exige plantillas aprobadas por Meta para iniciar una conversación fuera de la ventana de 24 horas: ```typescript // Crea una plantilla const template = await zavu.templates.create({ name: 'order_confirmation', language: 'en', whatsappCategory: 'UTILITY', headerType: 'text', headerContent: 'Order Confirmed!', body: 'Hi {{1}}, your order #{{2}} has been confirmed. Expected delivery: {{3}}.', footer: 'Reply HELP for assistance', buttons: [ { type: 'url', text: 'Track Order', url: 'https://track.example.com/{{1}}', example: 'ORD-12345' }, { type: 'quick_reply', text: 'Contact Support' } ] }) // Envíala a Meta para aprobación await zavu.templates.submit(template.id, { senderId: 'sender_abc123', category: 'UTILITY', variableExamples: { var1: 'John', var2: 'ORD-12345', var3: 'January 20, 2025' } }) ``` La aprobación llega por el webhook `template.status_changed`. ### Paso 3: Enviar mensajes con plantillas Una vez aprobada, envía la plantilla a tus clientes: ```typescript const { message } = await zavu.messages.send({ to: '+1234567890', messageType: 'template', content: { templateId: template.id, templateVariables: { '1': 'John', '2': 'ORD-12345', '3': 'January 20, 2025' }, templateButtonVariables: { '0': 'ORD-12345' } // rellena {{1}} en la URL del botón } }) ``` ## Mensajes interactivos Dentro de la ventana de 24 horas, WhatsApp admite mensajes interactivos: ```typescript // Envía un mensaje de lista await zavu.messages.send({ to: '+1234567890', messageType: 'list', text: 'How can we help you today?', content: { listButton: 'View Options', sections: [ { title: 'Support', rows: [ { id: 'track_order', title: 'Track my order' }, { id: 'return_item', title: 'Return an item' }, { id: 'billing', title: 'Billing question' } ] } ] } }) ``` ## Mejores prácticas 1. **Respeta el opt-in** - Solo escribe a usuarios que lo aceptaron explícitamente 2. **Usa las plantillas con criterio** - Mantenlas breves y útiles 3. **Vigila la categoría** - Meta puede recategorizar una plantilla (por ejemplo de UTILITY a MARKETING), lo que cambia su costo; `template.status_changed` trae la categoría vigente 4. **Responde rápido** - Los usuarios esperan respuestas rápidas en WhatsApp ## Límites y precios - **Plan Free**: 2.000 mensajes al mes entre WhatsApp, Telegram, Instagram y Messenger, contando ambas direcciones - **Planes de pago**: sin tope mensual de mensajes - **Cargos de Meta**: Meta cobra los mensajes de plantilla por categoría, aparte de tu plan de Zavu Consulta los [precios](/es/pricing) vigentes. **Listo para integrar WhatsApp?** [Comienza gratis](https://dashboard.zavu.dev) o [contáctanos](/es/contact-us) para más información. Únete a nuestra [comunidad de Discord](https://discord.gg/ZxE8DYkveh) para soporte y actualizaciones.