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.

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 Messenger?

• No. Puedes seguir usándolo para llamadas y SMS, pero no en WhatsApp Messenger.
• Si el número ya está en WhatsApp Messenger, elimínalo primero. No olvides respaldar tu historial de chats.
• Los números bloqueados deben desbloquearse antes del registro.

¿Puedo usar un número que esté en la app WhatsApp Business?

• Sí. Si tu número se usa actualmente en la aplicación WhatsApp Business, normalmente puedes incorporarlo a la Cloud API sin eliminar la cuenta de la app. Consulta la documentación de Meta sobre el onboarding por Coexistence.

¿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 → External Apps → WhatsApp → haz clic en el botón Conectar WhatsApp y sigue la ventana emergente de Meta:

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.

De vuelta en la Quickchat AI App, el panel de WhatsApp pasa a Conectado en unos 30 segundos. Si no ocurre, haz clic en el icono de actualizar del panel. De lo contrario, revisa los requisitos previos más arriba y asegúrate de haber proporcionado correctamente el número y la información empresarial.

¡Eso es todo, ya estás en producción! 🎉 Las personas pueden escribir a tu número de WhatsApp y tu AI Agent responderá automáticamente.

Consejo

Como verificación final, envía un mensaje de texto al número de WhatsApp que acabas de conectar. Deberías recibir la respuesta del AI Agent y la conversación debería aparecer en la bandeja de entrada de la Quickchat AI App. En la bandeja, también verás un mensaje de WhatsApp con un enlace a Setup guidance en el WhatsApp Manager. Sigue el enlace para completar el onboarding de WhatsApp.

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, la app muestra un mensaje pidiéndote que permitas las ventanas emergentes. Desactiva los bloqueadores de ventanas emergentes o rastreadores del navegador, recarga el sitio e inténtalo de nuevo. Si el problema continúa, prueba con otro navegador.

La verificación del número falló.

• Asegúrate de que el número pueda recibir SMS/llamadas y no esté bloqueado por otra ruta de registro activa que Meta no permita coexistir. Si el número se usa en la Business App, intenta el onboarding mediante Coexistence.

Conecté la cuenta equivocada.

• Haz clic en Reconectar en el panel de WhatsApp y repite el flujo usando la cuenta correcta de Meta Business y la cuenta de WhatsApp adecuada.

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.
• 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 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.

¿Necesitas ayuda?

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

O escanea el código QR: