Cómo conectar WhatsApp Business en 60 segundos con Konecia

Esta guía es para operadores de empresas-cliente de Konecia. Si nunca antes conectaste un WhatsApp Business Account (WABA) a una plataforma de mensajería, la primera vez puede parecer abrumador. Con el flow Embedded Signup oficial que habilitamos como Meta Tech Provider, son 60 segundos reales.

Antes de empezar

  • Tienes que ser administrador de un Business Manager en Meta (gratis crearlo si no lo tienes).
  • Necesitas un número de teléfono que NO esté actualmente en uso en WhatsApp ni WhatsApp Business app (puede ser un fijo, un VoIP o un celular sin la app).
  • Vas a definir un display name (el "verified name" que tus clientes van a ver).
  • Vas a recibir un código de verificación por SMS o llamada en ese número.

Pasos

Paso 1 — Inicia el flow desde Konecia

En tu workspace Konecia (app.konecia.io), ve a /integrations. Vas a ver un botón verde grande que dice "Conectar WhatsApp con Meta". Hazle clic.

Paso 2 — Elige Business Manager y WABA

Meta abre un dialog inline (no popup separado). Te muestra:

  • Los Business Managers donde eres admin. Eliges el que vas a usar para Konecia.
  • Las WABAs existentes en ese Business Manager, o la opción de crear una nueva.

Si es tu primera vez, vas a crear una WABA nueva ahí mismo.

Paso 3 — Display name y phone

Después de elegir/crear la WABA:

  • Display name: el nombre que tu cliente ve cuando recibe un mensaje tuyo. Tiene reglas (no puede ser solo URL, no puede ser todo mayúsculas). Meta valida en tiempo real.
  • Phone: el número que va a recibir el código de verificación. Meta te manda SMS o llamada.

Paso 4 — Verifica y firma

Pegas el código de verificación. Aceptas los términos de Meta. Si configuras 2FA, defines un PIN (importante: guárdalo en password manager).

Paso 5 — Konecia recibe el code y termina

Cuando confirmas, Meta cierra el dialog y le pasa a Konecia un authorization code. En 2-3 segundos:

  • Konecia exchange el code por un access token de larga vida.
  • Resuelve tu WABA ID via debug_token.
  • Hidrata metadata (phone_number_id, display name, quality rating).
  • Suscribe webhooks de mensajes inbound.
  • Registra tu número en Cloud API.
  • Crea el Channel + IntegrationConnection en tu workspace.

Ves un toast verde: "WhatsApp conectado · ({+tu phone}) está conectado a tu bandeja".

Después de los 60 segundos

Manda un mensaje desde tu teléfono personal al número que configuraste y debería aparecer en tu inbox de Konecia. Si no aparece en 30 segundos, ve a /integrations y haz clic en "Probar webhook" en la card de WhatsApp.

Problemas comunes

  • "Quality score: low" después de conectar — normal en las primeras 24h. Meta necesita tráfico real para evaluarte. Manda 5-10 mensajes de prueba a contactos que sabes que no te van a marcar como spam.
  • "display_name pending review" — Meta revisa manualmente nombres que parecen marcas registradas o que tienen patrones sospechosos. Toma 1-3 días hábiles.
  • "phone_number not registered" — el step 5 (/{phone_number_id}/register) requiere PIN cuando tienes 2FA. Si pusiste un PIN custom en step 4, ese es el que necesita. Konecia intenta primero con "000000" y si falla te muestra un campo para que metas el tuyo.

Si algo más se rompe

Solicita ayuda y un solution architect lo desbloquea contigo en una llamada de 15 minutos.