BotDesk
EnglishProbar gratis
← Volver al centro de ayuda/WhatsApp

Cómo conectar tu WhatsApp paso a paso

Guía completa para vincular tu propio número de WhatsApp Business a BotDesk: desde crear la app en Meta hasta enviar el primer mensaje de prueba.

Conecta tu propio número de WhatsApp para que tu bot responda a los mensajes de tus clientes, las 24 horas. La configuración se hace una sola vez.

Consejo: abre esta página y developers.facebook.com en dos pestañas del navegador. Irás copiando datos de una a otra.

Antes de empezar

Necesitas dos cosas:

  • Una cuenta en developers.facebook.com, vinculada a tu perfil de Facebook.
  • Un número de teléfono exclusivo — que no esté registrado en la app de WhatsApp ni en WhatsApp Business. Si ya lo usas en alguna de esas apps, primero tienes que eliminarlo de ahí.

¿Quieres probar el bot antes de comprometer tu número real? Salta al final, a Opción rápida: probar sin tu número.

Paso 1 — Crea tu app en Meta

En developers.facebook.com, haz clic en Mis aplicaciones → Crear aplicación.

Cuando te pida configuración inicial:

  • Nombre de la app: el de tu marca.
  • Correo de contacto: el tuyo.
  • Caso de uso: elige “Conecta con los clientes a través de WhatsApp”.
  • Porfolio empresarial: elige el de tu empresa si ya lo tienes (mejor si está verificado); si no, créalo con el nombre de tu marca.

Termina de crear la app.

Paso 2 — Añade tu número

Dentro de la app, en el menú lateral, entra en el caso de uso de WhatsApp y abre Configuración de la API.

  1. Pulsa Añadir número de teléfono, introduce el número y verifícalo con el código que recibirás por SMS o llamada.
  2. Cuando el número quede registrado, apunta estos dos datos de esa misma pantalla:
    • Identificador del número de teléfono — un código numérico largo, no el número en sí.
    • Identificador de la cuenta de WhatsApp Business (WABA ID).

Los necesitarás en los pasos 4 y 9.

Paso 3 — Crea un token permanente

Un token sin fecha de caducidad garantiza que el bot nunca pierda el acceso de forma inesperada.

  1. Ve a Configuración del negocio (Business Settings) → Usuarios del sistema.
  2. Pulsa Añadir, pon nombre al usuario y asígnale el rol Administrador.
  3. Asígnale tu app con control total.
  4. Pulsa Generar token:
    • Elige tu app.
    • En caducidad, selecciona Nunca.
    • Activa los permisos whatsapp_business_management y whatsapp_business_messaging.
  5. Copia el token y guárdalo en un lugar seguro. Solo se muestra una vez.

Paso 4 — Registra tu número (paso clave)

Sin este paso verás el error “La cuenta no existe en la API de nube”.

  1. Abre el Explorador de la API Graph.
  2. Elige tu app, añade los dos permisos de WhatsApp y pulsa Generar token de acceso.
  3. Cambia el método a POST e introduce la dirección TU_PHONE_NUMBER_ID/register, sustituyendo TU_PHONE_NUMBER_ID por el identificador del paso 2.
  4. Añade los parámetros del cuerpo:
    • messaging_product → whatsapp
    • pin → un PIN de 6 dígitos que elijas (anótalo, lo necesitarás si cambias el número)
  5. Pulsa Enviar. La respuesta debe ser { "success": true }.

Paso 5 — Copia tu clave secreta (App Secret)

En el menú lateral de tu app: Configuración → Información básica → Clave secreta de la aplicación → Mostrar (te pedirá tu contraseña de Facebook). Cópiala.

Paso 6 — Pega tus credenciales en BotDesk

En la pestaña Canales de la configuración de tu bot, rellena los tres campos:

Campo en BotDesk Qué pegar Dónde lo encontraste
Identificador del número de teléfono El código numérico del paso 2 Paso 2
Token de acceso El token permanente Paso 3
Clave secreta (App Secret) La clave secreta de la app Paso 5

Pulsa Conectar. BotDesk guardará las credenciales de forma cifrada.

Paso 7 — Registra el webhook

Al pulsar Conectar, BotDesk muestra una URL de callback y un código de verificación. Cópialos.

En Meta, dentro del caso de uso de WhatsApp, entra en Configuración → Webhooks y:

  1. Pega la URL en URL de devolución de llamada y el código en Identificador de verificación.
  2. Pulsa Verificar y guardar.
  3. Asegúrate de que messages aparece como Suscrito. Normalmente se activa solo; si no, búscalo en la lista y suscríbete manualmente.

Paso 8 — Publica la app

Mientras la app esté sin publicar, Meta no entrega los mensajes entrantes. Este paso es obligatorio.

En el menú lateral, entra en Publicar. Si te pide la URL de tu política de privacidad, pega el enlace (suele estar en el pie de tu sitio web). Publica la app.

Paso 9 — Activa la entrega de mensajes

De vuelta en el Explorador de la API Graph, con tu app y los dos permisos de WhatsApp activos:

  1. Cambia el método a POST e introduce la dirección TU_WABA_ID/subscribed_apps, sustituyendo TU_WABA_ID por el identificador del paso 2.
  2. Pulsa Enviar. La respuesta debe ser { "success": true }.

Paso 10 — Añade un método de pago

Con un número real, Meta requiere una tarjeta registrada para enviar mensajes a clientes.

Ve a Configuración del negocio → Facturación y pagos (o a WhatsApp Manager), localiza tu cuenta de WhatsApp y añade un método de pago con los datos fiscales de tu empresa.

Paso 11 — Pruébalo

Escribe un WhatsApp a tu número desde otro móvil. El bot debería responder en unos segundos.

Si el nombre del número aparece como “En revisión”: es normal. Meta revisa el nombre que verán tus clientes antes de aprobarlo, lo que puede tardar desde unos minutos hasta algunas horas. Durante ese periodo, la entrega de mensajes puede ser lenta.

¿El bot no responde? Revisa en este orden

  • Los tres campos en BotDesk están bien rellenados (paso 6).
  • El registro del paso 4 devolvió { "success": true }.
  • messages está suscrito en el webhook (paso 7).
  • La app está publicada (paso 8).
  • El subscribed_apps del paso 9 devolvió { "success": true }.
  • Hay un método de pago activo (paso 10).

Opción rápida: probar sin tu número {#opcion-rapida}

Si quieres ver el bot en acción antes de usar tu número real, Meta ofrece un entorno de prueba gratuito:

  1. Al crear la app (paso 1), elige la cuenta de prueba de Meta. Recibirás un número de prueba (+1) sin necesidad de tarjeta.
  2. En Destinatario, añade tu móvil con prefijo internacional (ej. +34 612 345 678) y confírmalo con el código que llega por WhatsApp. El número de prueba solo puede escribir a los contactos que añadas aquí (máximo 5).
  3. Haz los pasos de token (3), registro (4), webhook (7), publicación (8) y subscribed_apps (9) exactamente igual que arriba.
  4. Escribe al número de prueba desde tu móvil y el bot responderá.

El número de prueba sirve únicamente para validar la integración. Para atender a cualquier cliente con tu número real necesitas verificar el negocio en Meta y añadir una tarjeta de pago.