API oficial

Cómo conectar tu número en la API oficial de WhatsApp: paso a paso y los siete errores que bloquean la conexión

Por VeyloCRM · · 11 min de lectura

Conectar un número en la API oficial de WhatsApp es una secuencia corta de pantallas — y aun así es donde la mayoría de las empresas se atascan. Casi nunca es la plataforma: es un número que aún tiene WhatsApp activo, una cuenta comercial creada en duplicado, un nombre de exhibición que Meta rechaza o una persona sin permiso de administrador intentando autorizar. Esta guía es el orden correcto: qué preparar antes, qué decidir sobre el número, qué hacer en las primeras 48 horas y qué hace que el canal crezca en lugar de ser bloqueado.

Qué cambia realmente cuando el número pasa a la API

Antes de cualquier paso a paso, vale entender qué se está contratando, porque casi todos los errores de conexión nacen de una expectativa equivocada aquí.

El resumen honesto: la API oficial no es una versión mejorada de la aplicación. Es otra cosa. Resuelve equipo, historial, automatización, volumen y seguridad, y cobra a cambio disciplina de proceso y costo por conversación. Una empresa con un solo agente y veinte mensajes por día rara vez la necesita.

Qué necesitas tener antes de comenzar

La mitad de las conexiones que se atascan, se atascan por falta de algo de esta lista. Reúne todo antes de abrir la pantalla de conexión:

Esta última pregunta es la más importante de todas, y es el siguiente tema.

¿Número nuevo o el número que la empresa ya usa?

Hay tres escenarios, y cada uno tiene una consecuencia diferente:

El error más costoso de esta etapa: conectar un número nuevo y enviar mensajes masivos al día siguiente. Número sin historial, con alto volumen y sin opt-in, es el retrato exacto de lo que los sistemas de Meta bloquean. Si la decisión es número nuevo, el calentamiento no es opcional.

El paso a paso de la conexión

En la práctica, conectar por la plataforma es un flujo corto. Lo que suele tomar tiempo no es el clic, es la documentación.

Desde el clic hasta aquí, con todo en mano, son pocos minutos. Lo que viene después define si el canal funcionará.

Qué hacer en las primeras 48 horas

Número conectado no es canal listo. La secuencia que evita los problemas más comunes:

Límites, calidad y el comienzo pausado

Todo número nuevo comienza con un límite bajo de conversaciones iniciadas por día, y sube conforme envía con calidad y recibe respuesta. Ese escalón no se compra ni se acelera — es consecuencia del comportamiento.

Lo que hace subir el número: conversaciones respondidas, pocas denuncias, pocos bloqueos y volumen creciente de forma gradual. Lo que derriba: envío a lista comprada, mensaje inesperado para el cliente, contenido que parece publicidad y texto igual enviado a miles al mismo tiempo.

La lectura correcta es tratar la primera semana como calentamiento deliberado: pocos envíos, para quienes ya conversaron con la empresa, con contenido que pide respuesta. Vale más que cualquier configuración.

Lectura liberada

Sigue leyendo gratis

Completa una vez y desbloquea este y todos los demás artículos del blog. No cobramos nada — solo queremos saber para quién estamos escribiendo.

Toma 20 segundos. ¿Prefieres hablar directo en WhatsApp?

Opt-in: la parte que no es burocracia

La regla es simple de decir y fácil de ignorar: la empresa solo debería iniciar conversación con quien autorizó recibir mensajes de ella en ese número. No es solo política de Meta — es lo que separa un canal que crece de un número que es denunciado hasta morir.

Formas de opt-in que funcionan y quedan registradas:

  • Casilla de aceptación en el formulario del sitio, con texto que dice claramente que la empresa enviará mensajes por WhatsApp.
  • El propio cliente iniciando la conversación — botón en el sitio, enlace, código QR, anuncio que abre WhatsApp. Es el mejor opt-in que existe.
  • Aceptación en el momento de la compra o registro, con registro de fecha y origen.
  • Confirmación en el primer mensaje, con opción de salir, para bases antiguas.

Y lo que no vale: lista comprada, base de otro canal sin aviso, número recogido en evento sin mención a WhatsApp y planilla heredada de un vendedor que se fue.

Modelos de mensaje: qué aprueba y qué rechaza

Fuera de la ventana de 24 horas, toda conversación comienza con un modelo aprobado. Entender la lógica del análisis ahorra semanas:

  • Categoría correcta. Utilidad es para algo que el cliente espera, ligado a una transacción o actualización. Marketing es para promoción y novedad. Autenticación es para código de acceso. Enviar marketing disfrazado de utilidad es la razón número uno de rechazo y, peor, de reclasificación después.
  • Variables con ejemplo. Todo campo variable necesita un ejemplo real completado, si no rechaza.
  • Sin texto vago. Mensaje que no deja claro quién habla y por qué es rechazado.
  • Sin promesas ni apelaciones excesivas. Mayúsculas, exceso de emojis y urgencia artificial pesan en contra.
  • Los botones ayudan. Un botón para salir de la lista en mensaje de marketing reduce denuncias, que es lo que realmente protege el número.

Comienza con tres: una confirmación, un aviso de estado y una reanudación de conversación. Con estos tres, casi toda operación arranca.

El costo, sin sorpresas

El cobro de Meta es por conversación iniciada, con precio diferente por categoría y país. La conversación abierta por el cliente y respondida dentro de la ventana es la más barata — en muchos casos, sin costo. La iniciada por la empresa con modelo de marketing es la más cara.

La consecuencia práctica es buena para quien hace las cosas bien: cuanto más el cliente inicia la conversación, menor es el costo del canal. Invertir en botón en el sitio, enlace en anuncio y código QR impreso no es solo marketing — es reducción directa de costo operativo.

Un ejemplo para dar escala. Una empresa que envía 3.000 mensajes de reanudación por mes, todos iniciados por ella en categoría de marketing, paga un valor; la misma empresa que logra que la mitad de esos contactos inicie la conversación paga sensiblemente menos y además tiene mayor tasa de respuesta, porque quien escribió primero está interesado. El canal barato y el canal eficaz, aquí, son el mismo canal.

Coexistencia: cuándo tiene sentido

La coexistencia permite que el número siga funcionando en la aplicación WhatsApp Business y, al mismo tiempo, esté en la plataforma. Es el camino indicado cuando:

  • El equipo teme perder la atención del celular durante la transición.
  • Existe un historial grande en el dispositivo que la empresa no quiere abandonar de golpe.
  • El dueño atiende personalmente y quiere seguir respondiendo por el celular, mientras el equipo usa la plataforma.

Y cuando no tiene sentido: operación con varias personas, volumen alto o necesidad de automatización desde el primer día. En esos casos, mantener el celular en juego solo mantiene el desorden que motivó el cambio.

Los siete errores que bloquean la conexión

  • Número ya en uso en WhatsApp sin haber sido borrado antes, cuando la elección no fue coexistencia.
  • Crear un Administrador Comercial nuevo cuando la empresa ya tenía uno, generando dos portafolios y permisos divididos.
  • Nombre de exhibición genérico o sin relación con la empresa, que vuelve rechazado.
  • Persona sin permiso de administrador intentando autorizar. El pop-up se abre, pero no concluye.
  • Número que no recibe SMS ni llamada — VoIP y extensión suelen fallar en la verificación.
  • Bloqueador de pop-up impidiendo que se abra la ventana de Meta. Es algo común y bloquea a mucha gente.
  • Pendencia financiera o de verificación en la cuenta comercial, que impide el envío aunque todo esté conectado.

Cuándo vale la pena la API oficial — y cuándo no

Vale cuando existe al menos uno de estos: más de una persona atendiendo en el mismo número; necesidad de historial que no se pierda cuando alguien se va; automatización de primera respuesta y calificación; envío de confirmación, cobro o aviso en volumen; integración con CRM, sistema o tienda; y exigencia de control sobre lo que se dice en nombre de la marca.

No vale cuando la empresa tiene un solo agente, pocas conversaciones por día y ningún plan de crecer el canal. En ese caso, la aplicación resuelve, y el costo por conversación no se justifica.

La pregunta que decide, en la práctica, no es sobre tecnología: si la persona que atiende hoy se va mañana, ¿la empresa pierde las conversaciones? Si la respuesta es sí, el número está en el lugar equivocado — y esa es la razón por la cual la mayoría de las empresas termina migrando, incluso las que no tenían problema de volumen.

Preguntas frecuentes

¿Cuánto tiempo lleva conectar un número en la API oficial de WhatsApp?

La conexión en sí toma pocos minutos cuando todo está separado: cuenta comercial en el Administrador Comercial, una persona con acceso de administrador, el número que recibe SMS o llamada, los datos de la empresa y el nombre de exhibición elegido. Lo que suele alargar el proceso no es el clic sino lo que viene alrededor. El nombre de exhibición pasa por análisis y puede volver rechazado si es genérico o no tiene relación con la empresa. Los primeros modelos de mensaje deben ser enviados y analizados antes de que puedas iniciar conversación, y ese plazo no depende de ti. La verificación de la empresa en el Administrador Comercial, que libera límites mayores, implica documentación y tiene su propio plazo. Y si la elección es migrar el número que la empresa ya usa, aún existe la etapa de borrar la cuenta de la aplicación antes de conectar. En la práctica, cuenta minutos para conectar y algunos días para que el canal esté realmente operando.

¿Puedo usar el mismo número que la empresa ya usa en WhatsApp Business?

Puedes, y existen dos caminos con consecuencias diferentes. El primero es migrar definitivamente: borras la cuenta de ese número en la aplicación WhatsApp Business y conectas el número a la API. Esto preserva la relación, ya que los clientes tienen ese contacto guardado, pero el historial de conversaciones que está en el dispositivo no se transfiere a la plataforma. El segundo camino es la coexistencia, en la que el número sigue funcionando en la aplicación y al mismo tiempo pasa a existir en la plataforma, trayendo parte de los contactos y conversaciones recientes. La coexistencia es cómoda para quien teme perder la atención del celular durante la transición, o cuando el dueño quiere seguir respondiendo por el dispositivo mientras el equipo usa el sistema. Tiene menos sentido en operaciones con varias personas, volumen alto o necesidad de automatización desde el primer día, porque mantener el celular en juego mantiene justamente el desorden que motivó el cambio.

¿Por qué falla o se atasca la conexión del número?

Siete causas responden por la gran mayoría de los casos. El número aún tiene WhatsApp activo y no fue borrado antes, cuando la elección no fue coexistencia. Se creó un Administrador Comercial nuevo en lugar de usar el que la empresa ya tenía, lo que divide los permisos entre dos portafolios. El nombre de exhibición es genérico, como Atención o Ventas, y vuelve rechazado por no tener relación con la empresa. Quien intenta autorizar no tiene acceso de administrador en la cuenta comercial, entonces el pop-up se abre pero no concluye. El número no recibe SMS ni llamada de voz, lo que es común en VoIP y en extensión de central telefónica. El bloqueador de pop-up del navegador impide que se abra la ventana de Meta, que es una causa común y frecuente. Y, por último, existe una pendiente financiera o de verificación en la cuenta comercial, situación en la que el número conecta pero el envío sigue bloqueado.

La conexión es el comienzo. El canal es lo que viene después.

VeyloCRM conecta tu número a la API oficial de WhatsApp con la cuenta a nombre de tu empresa, organiza equipo e historial, cuida los modelos de mensaje y supervisa calidad y límites del número para que no descubras problemas por bloqueo.