WhatsApp

Esta guía explica cómo integrar tu Quickchat AI Agent con WhatsApp. El proceso se divide en 2 pasos sencillos:

• Paso 0 – Requisitos previos
• Paso 1 – Conectar WhatsApp

Si encuentras problemas durante la integración, consulta la sección Solución de problemas y FAQ o contáctanos.

Herramientas de configuración opcionales

• Comprobar requisitos de WhatsApp. Revisa los datos declarados del número y proveedor frente a los requisitos documentados. No accede a cuentas de WhatsApp ni las conecta.

• Comprobar una ventana de servicio de WhatsApp. Comprueba la ventana de 24 horas con las marcas de tiempo de entrada y respuesta que incluyan el desfase horario. No verifica plantillas, consentimiento ni permisos de cuenta, ni envía mensajes.

• Estimar costes de uso. Calcula los créditos de modelos de Quickchat AI y un total separado de los cargos proporcionados. No consulta tarifas de proveedores, combina créditos con dinero ni comprueba tu cuenta.

Los formularios están en inglés.

Ver el video

Play

Paso 0 – Requisitos previos

A. Número de teléfono empresarial

Decide qué número de teléfono usarás con WhatsApp. Consulta más detalles en la documentación de WhatsApp o en las preguntas frecuentes:

¿Qué número puedo usar en la WhatsApp Cloud API?

• Necesitas un número empresarial dedicado que pueda recibir SMS o llamadas para la verificación.
• El número debe ser válido, de tu propiedad y tener prefijo internacional y local.

¿Puedo usar un número que ya esté en WhatsApp personal (WhatsApp Messenger)?

• No. Puedes seguir usándolo para llamadas y SMS, pero no en WhatsApp personal.
• Para conectarlo, elimina la cuenta de WhatsApp de este número, espera unos minutos y luego conéctalo. Al eliminar la cuenta se borra su historial de chats, así que primero respalda tu historial de chats. Si quieres conservar tus chats, conecta otro número.
• Los números bloqueados deben desbloquearse antes del registro.

¿Puedo usar un número que ya se usa en la app de WhatsApp Business?

• Sí (beta). Puedes conectarlo y seguir usando la app de WhatsApp Business en tu teléfono. Tu AI Agent responde a los clientes en el mismo número y tus chats se quedan en la app. Meta llama a esto Coexistence. Consulta Seguir usando la app de WhatsApp Business (Coexistence).
• No elimines tu cuenta de WhatsApp Business ni migres el número para conectarlo.

¿Puedo usar un número nuevo?

• Sí. Si prefieres no usar tu número actual, adquiere un número nuevo (SIM física o número virtual). Puedes comprar números virtuales en servicios como Hushed.

B. Información empresarial

Ten estos datos a mano (los ingresarás durante el flujo de integración de Meta):

• Nombre de la empresa
• Sitio web de la empresa
• Categoría de la empresa
• Descripción de la empresa

Precaución

Aunque algunos campos parezcan opcionales, complétalos con información precisa. Datos faltantes o incorrectos pueden retrasar la aprobación o provocar restricciones.

Paso 1 – Conectar WhatsApp

Abre la Quickchat AI App → Canales → Aplicaciones externas → WhatsApp. En ¿Qué número vas a conectar?, elige la opción que corresponda a tu número:

• Un número nuevo que no está en WhatsApp: sigue los pasos de abajo.
• Un número que ya se usa en la app de WhatsApp Business: sigue Seguir usando la app de WhatsApp Business (Coexistence).
• Un número que ya se usa en WhatsApp personal: primero elimina la cuenta de WhatsApp de ese número (se borra su historial de chats), espera unos minutos y luego sigue los pasos de abajo. O usa otro número.

Luego haz clic en el botón Conectar WhatsApp y sigue la ventana emergente de Meta:

También puedes empezar desde ChatGPT, Claude u otra app de AI conectada: pide un enlace para conectar este Agente a WhatsApp. El enlace es válido durante 10 minutos y funciona una sola vez, únicamente para la cuenta de Quickchat que lo solicitó. Ábrelo en un navegador en el que hayas iniciado sesión en esa cuenta, sigue la configuración de Meta y completa cualquier selección de cuenta o teléfono cuando Quickchat se vuelva a abrir. Después, pide a tu app de AI que compruebe la configuración y envía un mensaje real de WhatsApp para confirmar que llega la respuesta de AI. Prueba cada número activo si conectas más de uno. Tú apruebas el acceso de Meta en el navegador, sin compartir tokens en el chat.

1. Inicia sesión en tu cuenta de Meta (Facebook).
2. Revisa los permisos que compartirás con Quickchat AI (acceso a la cuenta de WhatsApp Business y al Business portfolio) y continúa.
3. Proporciona datos empresariales precisos (Business Portfolio, Business Name, Business Website, país, etc.).
4. Crea o selecciona tu cuenta de WhatsApp Business.
5. Elige un nombre para mostrar y una categoría de WhatsApp Business.
6. Añade tu número empresarial y verifícalo por SMS/llamada cuando se te solicite.
7. Haz clic en Confirm para otorgar a Quickchat AI los permisos necesarios.
8. Cuando Meta confirme que la configuración está completa, haz clic en Finish. La ventana emergente muestra una confirmación de Quickchat AI de que tu cuenta de WhatsApp ha sido conectada y se cierra automáticamente.

Si el número se usa en la aplicación WhatsApp Business, elige conectar tu aplicación WhatsApp Business existente en la ventana de Meta y luego confirma en la aplicación cuando te lo pida (beta).

Si Meta concede a Quickchat AI acceso a más de una cuenta, el panel de WhatsApp muestra Elige tu cuenta de WhatsApp Business en lugar de conectarse de inmediato. Elige la cuenta en la que debe responder tu AI Agent y haz clic en Usar esta cuenta. Si te estás volviendo a conectar, tu configuración actual de WhatsApp no cambia hasta que confirmes.

De vuelta en la Quickchat AI App, el panel de WhatsApp muestra Completar configuración hasta que se verifique un intercambio correcto en tu propio número empresarial. Si el panel no se ha actualizado después de unos 30 segundos, haz clic en el icono de actualizar.

Conectarse a Meta y recibir un mensaje son solo parte de la configuración. El panel muestra el siguiente paso para cada número activado:

• Esperando tu primer mensaje: envía un mensaje de WhatsApp al número que se muestra desde otro teléfono y luego haz clic en Actualizar. Asegúrate de escribir al número empresarial que usarán tus clientes.
• Esperando la entrega de la respuesta de AI: Quickchat recibió tu mensaje, pero WhatsApp todavía no ha confirmado la entrega de la respuesta de AI. Comprueba si la respuesta llegó al otro teléfono. Si no llegó, revisa tus créditos AI y las advertencias del panel, y luego envía otro mensaje de prueba.
• Respuesta de AI entregada: WhatsApp confirmó que la respuesta de AI a un mensaje entrante se entregó en este número empresarial.
• La verificación requiere atención: resuelve las advertencias de conexión, mantén activado el número que quieres usar y envía un nuevo mensaje de prueba.
• Nombre visible: cada número listado más abajo en el panel lleva el estado de su nombre visible en Meta (Aprobado, En revisión, Rechazado, Caducado o Sin nombre visible). Una revisión en curso no requiere nada de tu parte y suele terminar en unos días. Si el nombre visible fue rechazado, caducó o falta, envía uno nuevo en WhatsApp Manager.
• Número de prueba de Meta: los números +1 555 asignados por Meta y los números de sandbox no verifican la activación en tu número empresarial. Añade tu propio número en WhatsApp Manager, actívalo en Quickchat y luego prueba ese número.

El panel muestra En vivo cuando cada número empresarial activado tiene un intercambio verificado y las comprobaciones de conexión son correctas. Si activas varios números empresariales, prueba cada uno. Un intercambio correcto con un número de prueba, el envío de una plantilla o un aviso sobre el límite de mensajes no completan esta comprobación.

Consejo

Mantén la integración activada mientras haces las pruebas. Envía un mensaje desde otro teléfono a cada número empresarial que quieras usar, confirma que llega la respuesta de AI y haz clic en Actualizar. La conversación también debería aparecer en la bandeja de entrada de la Quickchat AI App. Una conexión existente puede pedirte un nuevo intercambio de prueba para verificar la entrega; puede seguir recibiendo y respondiendo mensajes mientras completas este paso.

Si quedan pasos de onboarding de Meta pendientes, complétalos en Setup guidance, dentro de WhatsApp Manager. Quickchat AI también envía un recordatorio por correo electrónico al propietario de la cuenta cuando quedan pasos de configuración de Meta sin terminar.

Seguir usando la app de WhatsApp Business (Coexistence)

Puedes conectar un número que ya se usa en la app de WhatsApp Business y seguir usando la app en tu teléfono. Meta llama a esto Coexistence. En Quickchat AI está en beta. Sigues usando la app como antes mientras tu AI Agent responde a los clientes en el mismo número.

Antes de empezar

• Actualiza la app de WhatsApp Business de tu teléfono a la versión 2.24.17 o posterior.
• Si puedes, empieza la configuración en una computadora y ten cerca el teléfono con la app de WhatsApp Business. Confirmas la conexión en la app.

Conectar el número

1. En la Quickchat AI App, abre Canales → Aplicaciones externas → WhatsApp.
2. En ¿Qué número vas a conectar?, elige Un número que ya se usa en la app de WhatsApp Business. El panel muestra Sigue usando la app de WhatsApp Business (beta).
3. Haz clic en Conectar WhatsApp.
4. En la ventana de Meta, haz clic en Continue. Si Meta ofrece conectar tu app de WhatsApp Business existente, elige esa opción. Si no, elige Enter a new phone number y escribe el número que usas en la app de WhatsApp Business.
5. Cuando la app de WhatsApp Business de tu teléfono te lo pida, toca Connect y luego Confirm.
6. Es posible que Meta te pregunte si quieres compartir tu historial de chats. Es opcional. Quickchat AI no importa chats anteriores: la bandeja de entrada empieza desde el momento en que te conectas, y tus chats anteriores se quedan en la app.

Después envía un mensaje de prueba desde otro teléfono, como se describe arriba, hasta que el panel muestre En vivo.

Cómo funcionan las respuestas

• Los mensajes de los clientes y las respuestas de tu AI Agent aparecen tanto en la app de WhatsApp Business como en la bandeja de entrada de Quickchat AI.
• Cuando respondes a un cliente desde la app, el AI Agent deja de responder en ese chat.
• Cuando el chat lleva 4 horas sin actividad (sin mensajes de nadie), el siguiente mensaje del cliente inicia una nueva ronda de conversación y el AI Agent vuelve a responderle. Las 4 horas son fijas y no se pueden cambiar.
• Puedes devolver un chat en cualquier momento asignándolo al AI Agent en la bandeja de entrada.

Límites con este tipo de conexión

Meta aplica estos límites a un número conectado mediante Coexistence:

• Las listas de difusión se desactivan en la app de WhatsApp Business.
• Los chats de grupo no se sincronizan.
• WhatsApp para Windows no es compatible.
• Si no abres la app de WhatsApp Business en tu teléfono durante unos 14 días, Meta desconecta el número.

Precaución

Si Meta te pide liberar el número o eliminar tu cuenta de WhatsApp Business, no lo hagas. En su lugar, escribe a support@quickchat.ai.

Troubleshooting & FAQs

¿Cómo funciona la tarifa de WhatsApp Business API?

• Las respuestas a consultas iniciadas por el usuario (entrantes) se consideran mensajes de servicio. Permiten gestionar consultas entrantes con agentes humanos o bots conversacionales.
• Cuando un usuario escribe a una empresa se abre una ventana de servicio de 24 horas en la que puedes responder con mensajes de servicio sin costo. Esta ventana se reinicia con cada mensaje del usuario.
• Después de 24 horas, debes usar Message Templates aprobados (Marketing, Utility, Authentication, etc.) y pagar por mensaje según las tarifas de la plataforma WhatsApp Business.
• Meta categoriza y factura las conversaciones. Asegúrate de que tu cuenta de WhatsApp Business tenga un método de pago válido para mensajes iniciados por la empresa o basados en plantillas.

El botón Conectar WhatsApp no funciona. No aparece la ventana emergente de Meta.

• Si tu navegador bloquea la ventana emergente, permite las ventanas emergentes para Quickchat AI App y haz clic en Intentar de nuevo. También puedes hacer clic en Continuar en Meta en esta pestaña para completar la misma configuración sin una ventana emergente.

Quickchat no pudo confirmar la conexión de WhatsApp

Quickchat muestra este mensaje de recuperación cuando la ventana de Meta no devuelve ningún resultado y Quickchat aún no puede verificar la conexión. Esto no significa que Meta no haya realizado ningún cambio.

1. Confirma que eres administrador del negocio de Meta al que pertenece la cuenta de WhatsApp Business. Si no lo eres, pide a un administrador que la conecte desde su cuenta de Facebook.
2. Haz clic en Intentar de nuevo. Si un bloqueador interfiere con la ventana de Meta, usa una ventana privada con las extensiones desactivadas o haz clic en Continuar en Meta en esta pestaña.
3. Si el número está activo en WhatsApp personal, elimina la cuenta de WhatsApp de ese número (se borra su historial de chats), espera unos minutos y vuelve a intentarlo, o usa otro número. Si está activo en la app de WhatsApp Business, no necesitas eliminar nada: vuelve a conectar, elige Un número que ya se usa en la app de WhatsApp Business y, en la ventana de Meta, elige conectar tu app de WhatsApp Business existente. Consulta Seguir usando la app de WhatsApp Business (Coexistence).
4. Si la cuenta de WhatsApp Business usa Aircall, Twilio, 360dialog, MessageBird u otro proveedor, añade Quickchat AI como socio en Meta Business Settings:
   1. Abre Meta Business Settings y ve a Cuentas → Cuentas de WhatsApp.
   2. Selecciona la cuenta de WhatsApp Business, abre Socios y haz clic en Agregar socios.
   3. Introduce el Business ID de Quickchat AI: 270696274483463.
   4. Concede el permiso Administrar cuentas de WhatsApp, vuelve a Quickchat AI y actualiza el estado.

Desconecta el otro proveedor solo si Meta no permite que ambos socios estén en esa cuenta. Si tienes dudas, contacta con soporte antes de desconectar un proveedor de mensajería activo.

La verificación del número falló.

• Asegúrate de que el número pueda recibir SMS o llamadas.
• Si el número se usa en la app de WhatsApp Business, conéctalo mediante Coexistence y comprueba que la app tenga la versión 2.24.17 o posterior. No elimines tu cuenta de WhatsApp Business ni migres el número para intentar resolver el error.
• Un mensaje genérico Ineligible o el texto de ayuda This number can’t be shared with this app no permiten determinar la causa. Escribe a support@quickchat.ai con el mensaje exacto y el paso en el que apareció.

Conecté la cuenta equivocada.

• Reconectar mantiene la cuenta que ya está conectada. Para pasar el AI Agent a otra cuenta de WhatsApp Business, haz clic en Desconectar en el panel de WhatsApp, luego otra vez en Conectar WhatsApp, y elige la cuenta correcta de Meta Business y la cuenta de WhatsApp adecuada en la ventana de Meta.

No pudimos saber qué cuenta de WhatsApp Business conectar

• Tu inicio de sesión de Meta tiene varias cuentas de WhatsApp Business con números de teléfono y Quickchat no pudo saber cuál querías. Escribe a support@quickchat.ai con el número que quieres conectar y terminaremos la configuración por ti.

Los mensajes no aparecen en la bandeja de entrada de Quickchat AI.

• Confirma que la ventana emergente mostró el mensaje final “WhatsApp account connected!”.
• Revisa que conectaste el WhatsApp Account correcto y seleccionaste el AI Agent adecuado.
• La tarjeta Esperando tu primer mensaje indica el número en el que responde tu AI Agent. Asegúrate de haber escrito exactamente a ese número y de que esté activado en el panel, y luego haz clic en Actualizar.
• Si envías mensajes después de 24 horas sin interacción del usuario, usa plantillas aprobadas y asegúrate de tener un método de pago activo en el WhatsApp Manager.

Las respuestas de WhatsApp de mi AI no se envían.

Si las respuestas de tu AI no se pueden entregar, Quickchat AI muestra una alerta “Los mensajes de WhatsApp están fallando” en el panel de WhatsApp de Aplicaciones externas y una notificación en tu dashboard. Las causas y soluciones más comunes:

• Nombre visible sin aprobar en un número de prueba de Meta: Meta retiene las respuestas de un número +1 555 asignado por Meta hasta que se aprueba su nombre visible. La alerta del nombre visible en el panel se vuelve roja e indica el número. Espera a que termine la revisión (suele tardar unos días) o, si fue rechazado, envía un nuevo nombre visible en WhatsApp Manager, y luego envía un mensaje de prueba. Un nombre visible todavía en revisión en tu propio número no bloquea las respuestas por sí solo; el panel lo muestra como una nota.
• Conexión caducada o revocada: tu conexión de WhatsApp ya no es válida. Abre el panel de WhatsApp y haz clic en Reconectar para reanudar el envío de respuestas.
• Número restringido: Meta ha restringido tu número de WhatsApp (calidad o políticas). Revisa su estado en WhatsApp Manager para restablecer el envío.
• Cuenta de WhatsApp Business bloqueada (error 131031): Meta ha bloqueado las respuestas de la cuenta de WhatsApp Business. El error de entrega en la bandeja de entrada y el panel de WhatsApp explican la restricción. Abre Business Support Home, selecciona la cuenta de WhatsApp y la infracción, y solicita una revisión: Meta solo levanta un bloqueo de cuenta mediante esta revisión. Volver a conectar Quickchat no elimina la restricción.

Las demás alertas se borran automáticamente en cuanto una respuesta se envía correctamente de nuevo. Una alerta de bloqueo de cuenta se mantiene hasta que la respuesta de AI a un nuevo mensaje real de un visitante se haya entregado por completo, porque Meta puede aceptar una respuesta y aun así no entregarla. Si solo hay números de prueba de Meta (+1 555) activos, la siguiente respuesta de AI enviada correctamente la borra. La Support AI también puede explicar un fallo reciente registrado por bloqueo de cuenta, pero los datos históricos no demuestran que la cuenta siga bloqueada.

Las plantillas o los mensajes iniciados por la empresa fallan.

• Verifica que tus Message Templates estén aprobadas y que el WhatsApp Manager tenga un método de pago activo.
• Los nuevos remitentes comienzan con límites de mensajería que escalan según la calidad y la verificación. Si alcanzas un límite, revisa la guía de Meta sobre Messaging Limits.
• Consulta los límites de mensajería y la calificación de calidad en el WhatsApp Manager si se reducen las entregas.

¿Cómo crear mi propio enlace de WhatsApp y botón de “Chatear en WhatsApp”?

• Sigue este tutorial de WhatsApp.
• O bien, descarga los diseños oficiales de botones de marca de WhatsApp y utiliza uno de estos scripts en línea:

<!-- Botón de WhatsApp incrustado -->
<!-- Actualiza WHATSAPP_PHONE_NUMBER y el nombre/ruta del archivo según corresponda -->
<a
  aria-label="Chatear en WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chatear en WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

o

<!-- Botón flotante de WhatsApp -->
<!-- Actualiza WHATSAPP_PHONE_NUMBER y el nombre/ruta del archivo según corresponda -->
<a
  aria-label="Chatear en WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chatear en WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

¿Cómo crear mi propio código QR de WhatsApp?

• Visita WhatsApp Manager → Números de teléfono → selecciona tu número de empresa → Enlaces de mensajes → Crear enlace de mensaje.
• Alternativamente, puedes generarlo en la aplicación móvil de WhatsApp Business. Consulta este tutorial de WhatsApp.

¿Debo eliminar mi cuenta de la app de WhatsApp Business para solucionar un problema de configuración?

• No. Puedes conectar un número de la app de WhatsApp Business y seguir usando la app. Consulta Seguir usando la app de WhatsApp Business (Coexistence).
• Si Meta te pide liberar el número o eliminar tu cuenta de WhatsApp Business, no lo hagas. En su lugar, escribe a support@quickchat.ai.

¿Qué acceso obtiene Quickchat AI a nuestra cuenta de WhatsApp Business?

• Acceso limitado a la API, no propiedad de la cuenta. Tu cuenta de WhatsApp Business (WABA) está en tu propio Meta Business Manager. Con el modelo WABA Sharing de Meta, eres propietario de los activos y Quickchat AI se añade como un socio cuyo acceso puedes revocar en cualquier momento desde Business Manager.
• Podemos enviar y recibir mensajes mediante la Cloud API y recibir eventos de mensajes por webhook mientras la integración esté activa.
• No podemos cerrar, transferir ni cambiar la marca de tu cuenta, modificar la facturación ni eliminar a tus administradores.

¿Necesitas ayuda?

Chatea con el soporte de Quickchat AI en WhatsApp:
📱 +1 302-405-9992 — Inicia un chat

O escanea el código QR: