WhatsAppIntegraciónEmpresarial

Guía Completa de Integración con WhatsApp Business API

Todo lo que necesitas saber sobre la integración de WhatsApp Business API con Zavu para mensajería empresarial.

Redactado por: Jennifer VillalobosRevisado por: Victor Villalobos10 de enero de 202512 min
Ver como Markdown

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

  • Respeta el opt-in - Solo escribe a usuarios que lo aceptaron explícitamente
  • Usa las plantillas con criterio - Mantenlas breves y útiles
  • 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
  • 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 vigentes.

    Listo para integrar WhatsApp? Comienza gratis o contáctanos para más información. Únete a nuestra comunidad de Discord para soporte y actualizaciones.

    Necesitas ayuda? Contáctanos o únete a nuestra comunidad en Discord para soporte.

    Demo

    Mira cómo funciona

    Agenda una demo personalizada para ver cómo los Agentes IA de Zavu pueden transformar tu comunicación con clientes.

    Guía Completa de Integración con WhatsApp | Zavu Blog