Central de Ajuda Quaza Provedores

Guía de activación de la API Oficial de WhatsApp (paso a paso del proveedor) (ES-PY)

Guía de activación de la API Oficial de WhatsApp (paso a paso del proveedor) — Quaza

Guía de activación de la API Oficial de WhatsApp

Cómo crear y activar tu cuenta en la API Oficial de WhatsApp mediante la plataforma Quaza — que es BSP homologado por Meta y se encarga de toda la parte técnica. Esta guía muestra qué reunir antes de empezar y el paso a paso completo, desde el Meta Business Manager hasta el número listo para enviar y recibir mensajes.

Resumen: Quaza realiza la integración técnica (Embedded Signup, webhook y Cloud API) sin que necesites acceder a ningún panel de desarrollador de Meta. Tu parte es reunir los requisitos, crear la cuenta en Meta Business, preparar el número y autorizar el acceso. El proceso lleva de pocos minutos a algunos días hábiles, según el análisis de Meta.
En esta wiki:

Cuándo usar la API Oficial (y cuándo NO)

La API Oficial de WhatsApp (Cloud API de Meta) es el canal homologado para que el proveedor se comunique con los clientes a escala — enviar factura, aviso de vencimiento, código de aceptación de contrato y atender por el chat — con un número verificado y sin riesgo de bloqueo por uso indebido.

Usá la API Oficial cuando… NO es el camino cuando…
Querés enviar mensajes automáticos (factura, cobranza, aceptación) con un número estable y verificado por Meta. Solo querés probar el chat rápidamente — para eso existe la integración no oficial (ZApi), configurada en otra pantalla.
Necesitás límites altos de envío y plantillas aprobadas oficialmente. El número que pensás usar ya es el WhatsApp personal de la oficina y no puede perder el historial.
Querés reducir el costo de SMS reemplazándolo por mensajes de WhatsApp. La empresa todavía no tiene RUC/CNPJ activo, sitio propio ni documentación regular (Meta rechaza).

Antes de empezar — qué reunir

Reuní todos los ítems de abajo antes de iniciar el proceso. Los marcados como OBLIGATORIO bloquean la activación si faltan. El cuello de botella número 1 de los rechazos es el sitio de la empresa.

1. Cuenta personal en Facebook del responsable

Estado Requisito y orientación
OBLIGATORIO Perfil personal en Facebook activo. El Business Manager exige una cuenta personal para autenticación — no es posible crearlo sin ella. Los datos personales no aparecen para los clientes de la empresa.
ATENCIÓN Cuenta con al menos 30 días de uso y algo de actividad. Los perfiles muy nuevos o sin actividad se bloquean al crear el Business Manager. Si hace falta, usá el perfil de un socio.

2. Datos de la empresa — RUC/CNPJ y documentación

Estado Requisito y orientación
OBLIGATORIO RUC/CNPJ activo y regular. La situación tributaria debe estar "Activa". Documentos con pendencias, suspendidos o de baja son rechazados.
OBLIGATORIO Razón social idéntica en todos los documentos y en el Business Manager. Un espacio, punto o abreviatura diferente ya causa rechazo. Ej.: "Proveedor Internet S.A." ≠ "Proveedor Internet SA".
OBLIGATORIO Contrato social o comprobante de constitución de la empresa. Archivo nítido, sin cortes y sin marca de agua. Las fotos borrosas se rechazan automáticamente.
OBLIGATORIO Comprobante de domicilio de la empresa emitido en los últimos 3 meses. Factura de luz, agua o teléfono a nombre de la empresa (no del socio persona física), con el mismo domicilio del contrato social.

3. Sitio de la empresa — causa nº 1 de rechazos

Estado Requisito y orientación
OBLIGATORIO Sitio en línea con HTTPS activo (candado en el navegador). Los sitios sin HTTPS son rechazados en la verificación de dominio.
OBLIGATORIO Razón social completa y RUC/CNPJ visibles en el pie del sitio. Meta compara el contenido del sitio con los documentos. El pie debe incluir razón social + identificación tributaria + domicilio + teléfono, tal como en el registro oficial.
OBLIGATORIO Dominio propio registrado (ej.: proveedorxyz.com.py). Los sitios en subdominios gratuitos tienen una tasa de aprobación bajísima.
OBLIGATORIO Página de Política de Privacidad publicada y accesible en el sitio. Exigencia de Meta y de la ley de protección de datos.
ATENCIÓN Correo corporativo con dominio propio (ej.: contacto@proveedorxyz.com.py). Las cuentas Gmail/Hotmail debilitan el proceso.

4. Número de teléfono exclusivo

Estado Requisito y orientación
OBLIGATORIO Número NO registrado en ninguna app de WhatsApp (ni personal, ni Business). Si ya está en uso, hay que eliminar la cuenta dentro de la app antes de continuar — y eso borra todo el historial de conversaciones.
OBLIGATORIO Número capaz de recibir SMS o llamada de voz. El código de verificación de 6 dígitos llega por SMS o llamada. Si es un número fijo, no puede tener IVR ni grabación activa en el momento de la activación — la línea necesita atender la llamada de Meta.
OK Puede ser un número fijo, celular o virtual de cualquier operadora. Tras la activación, el número queda vinculado exclusivamente al chat de Quaza y deja de recibir llamadas por WhatsApp (solo llamadas normales de la operadora).

5. Tarjeta de crédito para el pago de los mensajes a Meta

Estado Requisito y orientación
OBLIGATORIO Tarjeta Visa o Mastercard con función internacional activa. Meta solo acepta Visa o Mastercard — otras marcas y tarjetas de débito no se aceptan.
ATENCIÓN El cobro se hace en dólares (USD), directamente por Meta. La factura llega en USD y el banco convierte según la cotización del día. Al agregar la tarjeta, Meta puede hacer una transacción de prueba simbólica que queda bloqueada hasta 48h.
El cuello de botella más común es el sitio: razón social diferente del registro oficial, identificación tributaria ausente en el pie o dominio sin HTTPS causan la mayoría de los rechazos. Verificá esto antes de enviar los documentos.

Visión general del proceso

Después de reunir los requisitos, la activación sigue las etapas de abajo. Quaza es BSP homologado por Meta y ejecuta la parte técnica; al cliente le corresponden el registro, la documentación y la autorización.

# Etapa Responsable Tiempo estimado
1 Crear cuenta en Meta Business Manager Cliente ~10 min
2 Verificación de negocio (envío de documentos) Cliente 3 a 10 días hábiles
3 Preparar el número de teléfono Cliente ~5 min
4 Conectar el número a Quaza (Embedded Signup) Quaza + Cliente ~5 min
5 Registro y aprobación de las plantillas Ambos 24 a 48h
6 Cuenta activa — tarjeta y ajustes finales Ambos Inmediato

Paso a paso de la activación

1Crear cuenta en Meta Business Manager

El Meta Business Manager es el panel central donde están todos los activos de negocio de la empresa en Meta. Es el punto de partida obligatorio.

  1. Ingresá a business.facebook.com e iniciá sesión con la cuenta de administrador (preferentemente el Facebook corporativo).
  2. Hacé clic en Crear cuenta y completá el nombre del negocio (la razón social exacta), tu nombre completo y el correo corporativo.
  3. Al crear la cuenta de WhatsApp Business, definí el Nombre para mostrar — es el nombre que verán los clientes. Debe coincidir con la razón social y el dominio del sitio, y no puede contener la palabra "WhatsApp" ni marcas de terceros.
  4. Activá la autenticación en dos pasos (2FA) cuando se solicite — es obligatoria.
Menú Agregar con la opción Crear nueva cuenta de WhatsApp

En Meta Business, en Configuración del negocio → Cuentas de WhatsApp, usá Agregar → "Crear nueva cuenta de WhatsApp".

Pantalla Crear una cuenta de WhatsApp Business con el campo Nombre para mostrar

Pantalla "Crear una cuenta de WhatsApp Business": el campo Nombre para mostrar debe traer el nombre comercial de la empresa.

El nombre del negocio y el Nombre para mostrar deben ser idénticos a la razón social de los documentos. Las discrepancias causan rechazo en la etapa de verificación.

2Verificación de negocio

La verificación de negocio es lo que libera los límites de envío. Sin ella, la cuenta opera en modo restringido (250 conversaciones por día).

Business Manager → Configuración del negocio → Centro de Seguridad → Iniciar verificación
  1. Informá identificación tributaria, razón social, domicilio, sitio y teléfono comercial — exactamente como en los documentos.
  2. Enviá los documentos sociales (contrato social o equivalente) cuando se solicite.
  3. Esperá el análisis de Meta (de 2 a 10 días hábiles, según el caso).
Centro de Seguridad de Meta Business mostrando la empresa verificada

Centro de Seguridad: cuando la verificación se concluye, la empresa aparece como "Verificada".

Una vez verificada, la cuenta sube de límite de envío según el volumen y la calidad de los mensajes — Meta promueve los niveles automáticamente:

Nivel Requisito Límite por día
Tier 0 Sin verificación 250 conversaciones
Tier 1 Negocio verificado 1.000 conversaciones
Tier 2 Tier 1 + volumen 10.000 conversaciones
Tier 3 Tier 2 + volumen Ilimitado

3Preparar el número de teléfono

El número usado en la API debe ser exclusivo — no puede estar activo en ninguna app de WhatsApp (personal o Business).

  1. Verificá si el número ya está registrado en alguna app de WhatsApp.
  2. Si lo está, hacé una copia de seguridad de las conversaciones (Ajustes → Chats → Copia de seguridad) y eliminá la cuenta dentro de la app (Ajustes → Cuenta → Eliminar mi cuenta).
Pantalla de la app WhatsApp para eliminar la cuenta del número

En la app, en Ajustes → Cuenta → Eliminar mi cuenta: hay que liberar el número antes de la activación.

Atención: eliminar la cuenta de la app WhatsApp borra permanentemente todo el historial de conversaciones de ese número. Hacé la copia de seguridad antes.

4Conectar el número a Quaza (Embedded Signup)

Esta es la etapa técnica, realizada por Quaza dentro del propio sistema. El cliente solo autoriza el acceso mediante el flujo oficial de Meta (Embedded Signup) — no necesita acceder a ningún panel de desarrollador.

Comunicación → Configuración de WhatsApp → Agregar configuración
  1. Creá una configuración con una Descripción y el Número que se usará.
  2. En el campo Integración, seleccioná "Meta business" y dejá la Situación como Habilitado.
  3. Hacé clic en "Conectar con Facebook Business". Se abre el inicio de sesión de Meta (con la cuenta de administrador, persona física) y luego el popup de autorización.
  4. Confirmá los permisos. Si la cuenta tiene más de un número, Quaza pregunta "Seleccione el número que desea utilizar" → hacé clic en Confirmar.
Pantalla de Quaza Agregar configuración de WhatsApp con Integración Meta business

En Quaza, la configuración con Integración = "Meta business"; los campos Número Teléfono API ID y Token se completan solos tras la conexión.

Popup de autorización Embedded Signup conectando la cuenta a Quaza

Popup de Meta (Embedded Signup): el cliente confirma y autoriza el acceso de Quaza.

Al confirmar, Quaza completa automáticamente los datos de integración (API ID y Token) y configura el webhook. Aparece el mensaje "¡Conexión con Facebook Business aplicada!" y el número queda listo. El cliente no necesita acceder a ningún panel técnico de Meta.

5Registro y aprobación de las plantillas

Con el número activo, los mensajes enviados fuera de la ventana de 24h deben usar plantillas aprobadas por Meta. El plazo de aprobación es de 24 a 48h.

WhatsApp Manager con la lista de plantillas de mensaje en análisis

Administrador de WhatsApp → Plantillas de mensaje: cada plantilla entra "En análisis" hasta que Meta la aprueba.

Al crear la plantilla, seleccioná manualmente la categoría "Utilidad" (Meta suele preseleccionar "Marketing"). Las plantillas de Marketing tienen un costo mayor y exigen opt-in explícito del contacto.

El paso a paso detallado de creación e importación de plantillas está en la wiki propia — ver Registro e importación de plantillas (WhatsApp Meta Business) .

6Cuenta activa — tarjeta y ajustes finales

Con el número activo y las plantillas aprobadas, falta registrar la tarjeta de crédito que paga los mensajes a Meta.

Business Manager → Configuración del negocio → Cuentas de WhatsApp → Configuración de pago
  1. En Agregar forma de pago, seleccioná la moneda Dólar estadounidense (USD) — Meta convierte en la factura.
  2. Ingresá los datos de la tarjeta Visa o Mastercard y guardá.
Ventana Agregar datos de pago con moneda en dólar

Agregar datos de pago: seleccioná la ubicación y la moneda (Dólar estadounidense) antes de ingresar la tarjeta.

Resumen de la cuenta en Meta Business con verificación y estado aprobado

Resumen de la cuenta: con la empresa "Verificada" y el estado "Aprobada", el número ya puede enviar y recibir mensajes.

Sin tarjeta registrada, las plantillas no se disparan fuera de la ventana de 24h. Registrá la tarjeta antes de los primeros envíos.
¡Cuenta activa! El número ya envía y recibe mensajes por la API Oficial. A partir de aquí la atención y los envíos ocurren por el chat y por los disparos de Quaza.

Flujo — quién hace qué

El proceso involucra tres actores: el cliente (proveedor), Quaza (BSP) y Meta. El diagrama de abajo muestra el orden de las etapas y de quién es cada una.

CLIENTE (proveedor) QUAZA (BSP) META 1 Crea cuenta en BusinessManager + Nombre para mostrar 2 Envía documentos paraverificación de negocio Analiza y verifica3 a 10 días hábiles 3 Libera el número(lo quita de apps WhatsApp) 4 Abre el Embedded Signupen Configuración WhatsApp Autoriza el accesoy elige el número 5 Configura webhook yCloud API (automático) Verifica númeropor SMS / llamada 6 Registra plantillascategoría Utilidad Aprueba plantillas24 a 48h 7 Registra tarjetaVisa/Master en USD Cuenta activaenvía y recibe mensajes

Glosario

Término Qué es
Meta Business Manager Panel central de Meta (business.facebook.com) donde están los activos de negocio de la empresa: cuentas de WhatsApp, verificación, pagos.
BSP Business Solution Provider — socio homologado por Meta para integrar empresas a la API Oficial. Quaza es BSP.
API Oficial / Cloud API La interfaz oficial de WhatsApp para enviar y recibir mensajes de forma programática, alojada por Meta.
Embedded Signup Flujo oficial de Meta en el que el cliente autoriza al BSP a configurar la cuenta, sin manipular tokens manualmente.
WABA WhatsApp Business Account — la cuenta de WhatsApp de la empresa dentro de Meta, que agrupa los números.
Nombre para mostrar El nombre que ven los clientes en las conversaciones. Pasa por aprobación de Meta y debe reflejar a la empresa.
Plantilla Mensaje preaprobado por Meta, obligatorio para iniciar conversación fuera de la ventana de 24h. Tiene categoría (Utilidad o Marketing).
Ventana de 24h Período tras el último mensaje del cliente en que la empresa puede responder libremente. Fuera de ella, solo con plantilla.
Verificación de negocio Análisis de Meta que confirma que la empresa existe y libera los límites de envío (salir del modo restringido de 250 conversaciones/día).
Tier Nivel de límite de mensajes por día. Sube automáticamente según volumen y calidad.

Errores frecuentes

  1. Sitio fuera del estándar. Razón social diferente del registro oficial, identificación tributaria ausente en el pie o dominio sin HTTPS — causa nº 1 de rechazo. Ajustá el sitio antes de enviar documentos.
  2. Razón social con diferencia mínima. Un punto, espacio o abreviatura diferente entre el Business Manager y los documentos ya rechaza la verificación.
  3. Número todavía activo en un WhatsApp. Si el número está en cualquier app de WhatsApp, hay que eliminar la cuenta primero — y eso borra el historial. Hacé la copia de seguridad antes.
  4. Número fijo con IVR o grabación. La línea necesita atender la llamada de verificación de Meta; el IVR/grabación impiden que llegue el código.
  5. Tarjeta no aceptada. Solo Visa o Mastercard con función internacional. Otras marcas y débito son rechazadas. El cobro llega en dólares.
  6. Plantilla creada como "Marketing". Meta preselecciona Marketing; seleccioná "Utilidad" manualmente para evitar un costo mayor y la exigencia de opt-in.
  7. Sin tarjeta registrada. Las plantillas no se disparan fuera de la ventana de 24h mientras no haya forma de pago en la cuenta.
  8. Nombre para mostrar con "WhatsApp" o marca de terceros. Es rechazado por Meta. Usá el nombre comercial de la empresa.

Preguntas frecuentes

¿Cuánto tiempo lleva la activación completa?

La parte técnica (paso 4) lleva minutos. Lo que demora es la verificación de negocio de Meta — de 3 a 10 días hábiles — y la aprobación de las plantillas (24 a 48h). Reunir los documentos correctos de antemano es lo que más acelera.

¿Necesito acceder a algún panel de desarrollador de Meta?

No. Quaza, como BSP, hace toda la parte técnica mediante el Embedded Signup. Vos solo autorizás el acceso por el popup oficial de Meta dentro de Quaza.

¿Puedo usar el WhatsApp de la empresa que ya uso en el celular?

Solo si liberás el número antes — eliminando la cuenta dentro de la app, lo que borra el historial. Lo ideal es usar un número exclusivo para la API.

¿Puedo usar un número fijo?

Sí, siempre que reciba SMS o llamada y no tenga IVR/grabación activa en el momento de la verificación, ya que Meta envía un código de 6 dígitos por llamada.

¿Cuánto cuesta por mensaje?

Meta cobra por conversación, en dólares, según la categoría. Los mensajes de utilidad son más baratos que los de marketing, y las respuestas dentro de la ventana de 24h son gratuitas. Los valores y la tabla oficial los define Meta.

¿Por qué se rechazó mi verificación?

En la mayoría de los casos es el sitio: sin HTTPS, sin razón social/identificación tributaria en el pie, o dominio gratuito. También se rechaza cuando la razón social en el Business Manager difiere del registro oficial. Ajustá e intentá de nuevo.

¿Qué es la ventana de 24h?

Es el período tras el último mensaje del cliente en que la empresa puede responder libremente. Pasado ese tiempo, solo se puede iniciar contacto con una plantilla aprobada.

¿Cuál es la diferencia entre plantilla de Utilidad y de Marketing?

Utilidad es para mensajes transaccionales (factura, aviso de vencimiento, aceptación) — más barato. Marketing es para promoción y exige opt-in del contacto, con un costo mayor.

¿Dónde registro el número después de verificado?

En Comunicación → Configuración de WhatsApp, creando una configuración con Integración "Meta business" y haciendo clic en "Conectar con Facebook Business".

¿El número va a seguir recibiendo llamadas de WhatsApp?

No. Tras la activación, el número queda vinculado exclusivamente al chat de Quaza y deja de recibir llamadas por WhatsApp — solo llamadas normales de la operadora.

¿Y si la conexión automática con Facebook Business no funciona?

Rehacé el paso "Conectar con Facebook Business" con la cuenta de administrador (persona física). Si persiste, abrí un ticket en el Soporte Quaza con la captura del error.

Documentos relacionados