Saltar al contenido
HablariHablari
Empezar gratis

Centro de ayuda

Guías paso a paso para conectar cada canal con Hablari. Sin código: consigues las credenciales en el proveedor y las pegas dentro de Hablari, en Ajustes → Integraciones (solo el owner de la empresa). Las credenciales se guardan cifradas y nunca se muestran de vuelta.

WhatsApp Cloud API

Conecta tu número de WhatsApp Business desde Meta for Developers.

  1. 1Entra en developers.facebook.com → «Mis apps» → «Crear app» y elige el tipo «Empresa/Negocio».
  2. 2En «Agregar productos», busca «WhatsApp» y pulsa «Configurar».
  3. 3Abre WhatsApp → «Configuración de la API»: ahí verás el Phone Number ID y el WhatsApp Business Account ID.
  4. 4Conecta tu cuenta de WhatsApp Business y copia el «Phone Number ID».
  5. 5Ve a Meta Business Suite → «Configuración del negocio» → «Usuarios del sistema» → «Agregar» con rol Administrador.
  6. 6Pulsa «Asignar activos» y añade tu app y tu cuenta de WhatsApp Business con «Control total».
  7. 7Pulsa «Generar token», marca los permisos whatsapp_business_messaging y whatsapp_business_management, y copia el token permanente.
  8. 8Inventa una cadena secreta (p. ej. «hablari-verify-2026»): será tu Verify token. Pégala en Hablari.
  9. 9En WhatsApp → «Configuración», pega la URL del webhook y el mismo Verify token, y suscríbete al campo «messages».

El token que aparece en «Configuración de la API» caduca en 24 h: usa el token permanente del usuario del sistema (paso 7). Para escribir a clientes reales (no las de prueba), Meta exige verificar tu negocio.

Documentación oficial de WhatsApp Cloud API

Instagram DM

Vincula tu Instagram profesional a una página de Facebook y genera un token.

  1. 1Pon tu cuenta de Instagram en modo profesional (Empresa) y conéctala a una página de Facebook.
  2. 2En developers.facebook.com crea una app de tipo «Negocio».
  3. 3Añade los productos «Instagram» e «Inicio de sesión de Facebook para empresas».
  4. 4En «Instagram → Configuración de la API», pulsa «Generar token de acceso» e inicia sesión con el Facebook dueño de la página.
  5. 5Concede los permisos instagram_basic, instagram_manage_messages, instagram_manage_comments y pages_messaging, y autoriza tu página.
  6. 6En el Explorador de la Graph API, llama a GET /me/accounts pidiendo los campos access_token e instagram_business_account.
  7. 7Copia el access_token (token de la página) y el instagram_business_account.id (tu Instagram Business ID).
  8. 8Para que el token no caduque, crea un «Usuario del sistema» en Configuración del negocio y genera un token permanente con esos permisos.
  9. 9Pega el Instagram Business ID y el token en Hablari.

Tu Instagram debe ser profesional (Empresa) y estar vinculado a una página de Facebook. Los tokens de inicio de sesión caducan (~60 días): usa el de un usuario del sistema (paso 8). Para clientes reales, Meta exige App Review. Para recibir también los COMENTARIOS de tus publicaciones, concede además instagram_manage_comments (la respuesta le llega a la persona por privado — Meta permite 1 respuesta por comentario, dentro de 7 días).

Documentación oficial de Instagram DM

Email (dominio propio)

Conecta el correo de tu empresa (p. ej. soporte@tudominio.com) vía Resend.

  1. 1En resend.com → «Domains» → «Add Domain», añade tu dominio (p. ej. tudominio.com).
  2. 2Copia los registros DNS que muestra Resend (SPF/DKIM y el MX del subdominio de envío) y añádelos en tu proveedor de DNS; espera a que el dominio quede «Verified».
  3. 3En resend.com → «Domains» → tu dominio → «Receiving», activa la recepción y apunta el webhook a https://www.hablari.com/api/webhooks/email.
  4. 4Vuelve aquí y escribe la dirección desde la que atenderás (p. ej. soporte@tudominio.com) y el nombre a mostrar.

Funciona con un dominio propio (no Gmail/Outlook personales) vía Resend: enviar por API + recibir por webhook, sin SMTP. Requiere añadir los registros DNS (SPF/DKIM/MX) que da Resend a tu dominio y verificarlo. Hablari gestiona la API key; tú solo configuras tu dirección y el DNS. Las respuestas que escribas aquí le llegan a el cliente como respuesta a su correo (mismo hilo).

Documentación oficial de Email (dominio propio)

Telegram

Crea un bot con @BotFather, copia el token e inventa una cadena de verificación.

  1. 1Abre Telegram y busca @BotFather.
  2. 2Envía el comando /newbot y sigue las instrucciones: elige un nombre y un @username (debe terminar en «bot»).
  3. 3BotFather te dará el «HTTP API token» (empieza por un número seguido de dos puntos). Cópialo.
  4. 4Inventa una cadena secreta cualquiera (p. ej. «hablari-telegram-2026-tuempresa»). Será tu Webhook secret.
  5. 5Pega ambos valores aquí. Hablari registrará el webhook de Telegram automáticamente al guardar.

Cada empresa necesita su propio bot. El «Webhook secret» es una cadena que tú inventas (mínimo 1 carácter, máximo 256); Telegram la incluye en cada webhook para que Hablari verifique que el mensaje es auténtico. Al guardar las credenciales, Hablari registra el webhook automáticamente.

Documentación oficial de Telegram

Facebook Messenger

Conecta tu página de Facebook para recibir y responder mensajes de Messenger.

  1. 1En developers.facebook.com → «Mis apps» → «Crear app», elige el tipo «Negocio».
  2. 2Añade el producto «Messenger» y ve a «Configuración de Messenger».
  3. 3En «Tokens de acceso» → «Agregar o eliminar páginas», conecta tu página de empresa y genera el token.
  4. 4Copia el «ID de la página» (número largo debajo del nombre de la página).
  5. 5Para un token permanente: Meta Business Suite → «Configuración del negocio» → «Usuarios del sistema» → crea uno con rol Admin → «Asignar activos» (app + página) → «Generar token» con permisos pages_messaging.
  6. 6En «Webhooks de Messenger», pulsa «Agregar URL de devolución de llamada», pega https://www.hablari.com/api/webhooks/messenger y tu Verify token, y suscríbete al campo «messages».
  7. 7Copia tu Page ID, el token de la página y el Verify token, y pégalos aquí.

El token de página caduca salvo que uses el de un usuario del sistema (rol Admin). Para responder a usuarios fuera de la ventana de 24 h necesitas una plantilla de mensaje aprobada por Meta. Requiere App Review de Meta para producción.

Documentación oficial de Facebook Messenger

Shopify

Crea una app en el Dev Dashboard de Shopify y copia su Client ID y Client secret.

  1. 1Entra en el Dev Dashboard de Shopify (shopify.dev/dashboard) con tu cuenta y elige tu organización.
  2. 2Pulsa «Create app» → «Create app manually», ponle un nombre (p. ej. «Hablari») y créala.
  3. 3En «Configuration» → «Admin API access scopes», marca read_orders, read_customers, read_products y write_orders (write_orders es necesario para gestionar pedidos —cancelar, reembolsar, editar dirección— desde el inbox). Guarda.
  4. 4Instala la app en tu tienda: pestaña «Overview» o «Test your app» → «Install» y elige tu tienda.
  5. 5Ve a «Client credentials» (o «API credentials») y copia el «Client ID» y el «Client secret».
  6. 6Copia tu dominio xxxxx.myshopify.com (Configuración → Datos de la tienda en el admin).
  7. 7Pega en Hablari el dominio, el Client ID y el Client secret. Nosotros generamos y renovamos el token.

Método actual (desde 2026): las «custom apps» del admin con token shpat_ están deprecadas para tiendas nuevas (1-ene-2026). Ahora la app se crea en el Dev Dashboard y Hablari obtiene el token solo (Client Credentials Grant; se renueva automáticamente cada 24 h). La app debe estar INSTALADA en tu tienda antes de conectar. Si ya tenías una tienda conectada con token shpat_, sigue funcionando.

Documentación oficial de Shopify

Klaviyo

Crea una Private API Key de solo lectura en los ajustes de Klaviyo.

  1. 1En Klaviyo, pulsa el nombre de tu cuenta (abajo a la izquierda) y entra en «Settings» (Configuración).
  2. 2Abre la pestaña «API keys».
  3. 3Pulsa «Create Private API Key».
  4. 4Ponle un nombre que identifique la app (p. ej. «Hablari»).
  5. 5Elige el ámbito «Read-Only Key» (solo lectura).
  6. 6Pulsa «Create» y copia al momento la clave que empieza por pk_ (no se vuelve a mostrar).
  7. 7Pega esa clave en Hablari.

Es la Private API Key (pk_…), no el Site ID público de 6 caracteres. Se muestra una sola vez; si te equivocas de permisos, bórrala y crea otra. Necesitas rol Owner, Admin o Manager en Klaviyo.

Documentación oficial de Klaviyo

AfterShip

Conecta AfterShip con tu API key para ver el estado de cada envío.

  1. 1En aftership.com, inicia sesión y ve a «Settings» → «API Keys».
  2. 2Pulsa «Generate API Key», ponle un nombre (p. ej. «Hablari») y cópiala.
  3. 3Pega la key aquí. Hablari la usará para consultar el estado de tus envíos.

AfterShip soporta más de 1.000 transportistas. El tracking se consulta al abrir un pedido; no hay mensajes entrantes. La API key se genera en aftership.com → Settings → API Keys.

Documentación oficial de AfterShip

Recharge

Conecta Recharge con tu API key para ver las suscripciones de cada cliente.

  1. 1En tu tienda Shopify, abre la app Recharge.
  2. 2Ve a «Settings» → «Integrations» → «API tokens».
  3. 3Pulsa «Create an API token», dale un nombre («Hablari»), elige permisos de solo lectura y cópialo.
  4. 4Pega el token aquí.

Solo lectura: Hablari consulta las suscripciones al abrir la ficha del cliente. La API key se genera en Recharge → «API tokens». Requiere plan Standard o superior de Recharge.

Documentación oficial de Recharge

Preguntas frecuentes

¿Necesito conocimientos técnicos para conectar un canal?

No. Cada guía está pensada para gente no técnica: creas la app o consigues las credenciales en el proveedor (WhatsApp, Instagram, Shopify…) y las pegas en Ajustes → Integraciones. Hablari se encarga del resto.

¿Dónde pego las credenciales?

Dentro de Hablari, en Ajustes → Integraciones. Solo el owner de la empresa puede conectar canales; las credenciales se guardan cifradas y nunca se muestran de vuelta.

¿Puedo usar mi número de WhatsApp actual?

Sí, con WhatsApp Cloud API usas un único número para recibir y enviar. Al migrar a la API, ese número deja de usarse en la app del móvil.

¿Aún no tienes cuenta? Créala gratis y conecta tu primer canal hoy.

Centro de ayuda: guías de integración · Hablari