Vés al contingut
HablariHablari
Comença gratis

Centre d'ajuda

Guies pas a pas per connectar cada canal amb Hablari. Sense codi: aconsegueixes les credencials al proveïdor i les enganxes dins de Hablari, a Configuració → Integracions (només el propietari de l'empresa). Les credencials es desen xifrades i mai no es tornen a mostrar.

WhatsApp Cloud API

Connecta el teu número de WhatsApp Business des de Meta for Developers.

  1. 1Entra a developers.facebook.com → «Les meves apps» → «Crear app» i tria el tipus «Empresa/Negoci».
  2. 2A «Afegir productes», busca «WhatsApp» i prem «Configurar».
  3. 3Obre WhatsApp → «Configuració de l'API»: allà veuràs el Phone Number ID i el WhatsApp Business Account ID.
  4. 4Connecta el teu compte de WhatsApp Business i copia el «Phone Number ID».
  5. 5Ves a Meta Business Suite → «Configuració del negoci» → «Usuaris del sistema» → «Afegir» amb rol Administrador.
  6. 6Prem «Assignar actius» i afegeix la teva app i el teu compte de WhatsApp Business amb «Control total».
  7. 7Prem «Generar token», marca els permisos whatsapp_business_messaging i whatsapp_business_management, i copia el token permanent.
  8. 8Inventa una cadena secreta (p. ex. «hablari-verify-2026»): serà el teu verify token. Enganxa-la a Hablari.
  9. 9A WhatsApp → «Configuració», enganxa l'URL del webhook i el mateix verify token, i subscriu-te al camp «messages».

El token que apareix a «Configuració de l'API» caduca en 24 h: fes servir el token permanent de l'usuari del sistema (pas 7). Per escriure a clients reals (no els de prova), Meta exigeix verificar el teu negoci.

Documentació oficial de WhatsApp Cloud API

Instagram DM

Vincula el teu Instagram professional a una pàgina de Facebook i genera un token.

  1. 1Posa el teu compte d'Instagram en mode professional (Empresa) i connecta'l a una pàgina de Facebook.
  2. 2A developers.facebook.com crea una app de tipus «Negoci».
  3. 3Afegeix els productes «Instagram» i «Inici de sessió de Facebook per a empreses».
  4. 4A «Instagram → Configuració de l'API», prem «Generar token d'accés» i inicia sessió amb el Facebook propietari de la pàgina.
  5. 5Concedeix els permisos instagram_basic, instagram_manage_messages, instagram_manage_comments i pages_messaging, i autoritza la teva pàgina.
  6. 6A l'Explorador de la Graph API, crida GET /me/accounts demanant els camps access_token i instagram_business_account.
  7. 7Copia l'access_token (token de la pàgina) i l'instagram_business_account.id (el teu Instagram Business ID).
  8. 8Perquè el token no caduqui, crea un «Usuari del sistema» a Configuració del negoci i genera un token permanent amb aquests permisos.
  9. 9Enganxa l'Instagram Business ID i el token a Hablari.

El teu Instagram ha de ser professional (Empresa) i estar vinculat a una pàgina de Facebook. Els tokens d'inici de sessió caduquen (~60 dies): fes servir el d'un usuari del sistema (pas 8). Per a clients reals, Meta exigeix App Review. Per rebre també els COMENTARIS de les teves publicacions, concedeix a més instagram_manage_comments (la resposta arriba a la persona en privat — Meta permet 1 resposta per comentari, dins de 7 dies).

Documentació oficial de Instagram DM

Email (dominio propio)

Connecta el correu de la teva empresa (p. ex. suport@teudomini.com) via Resend.

  1. 1A resend.com → «Domains» → «Add Domain», afegeix el teu domini (p. ex. teudomini.com).
  2. 2Copia els registres DNS que mostra Resend (SPF/DKIM i el MX del subdomini d'enviament) i afegeix-los al teu proveïdor de DNS; espera que el domini quedi «Verified».
  3. 3A resend.com → «Domains» → el teu domini → «Receiving», activa la recepció i apunta el webhook a https://www.hablari.com/api/webhooks/email.
  4. 4Torna aquí i escriu l'adreça des de la qual atendràs (p. ex. suport@teudomini.com) i el nom a mostrar.

Funciona amb un domini propi (no Gmail/Outlook personals) via Resend: enviar per API + rebre per webhook, sense SMTP. Cal afegir els registres DNS (SPF/DKIM/MX) que dona Resend al teu domini i verificar-lo. Hablari gestiona l'API key; tu només configures la teva adreça i el DNS. Les respostes que escriguis aquí arriben al client com a resposta al seu correu (mateix fil).

Documentació 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ó 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ó oficial de Facebook Messenger

Shopify

Crea una app al Dev Dashboard de Shopify i copia el seu Client ID i Client secret.

  1. 1Entra al Dev Dashboard de Shopify (shopify.dev/dashboard) amb el teu compte i tria la teva organització.
  2. 2Prem «Create app» → «Create app manually», posa-li un nom (p. ex. «Hablari») i crea-la.
  3. 3A «Configuration» → «Admin API access scopes», marca read_orders, read_customers, read_products i write_orders (write_orders cal per gestionar comandes —cancel·lar, reemborsar, editar adreça— des de la safata). Desa.
  4. 4Instal·la l'app a la teva botiga: pestanya «Overview» o «Test your app» → «Install» i tria la teva botiga.
  5. 5Ves a «Client credentials» (o «API credentials») i copia el «Client ID» i el «Client secret».
  6. 6Copia el teu domini xxxxx.myshopify.com (Configuració → Dades de la botiga a l'admin).
  7. 7Enganxa a Hablari el domini, el Client ID i el Client secret. Nosaltres generem i renovem el token.

Mètode actual (des del 2026): les «custom apps» de l'admin amb token shpat_ estan obsoletes per a botigues noves (1-gen-2026). Ara l'app es crea al Dev Dashboard i Hablari obté el token sol (Client Credentials Grant; es renova automàticament cada 24 h). L'app ha d'estar INSTAL·LADA a la teva botiga abans de connectar. Si ja tenies una botiga connectada amb token shpat_, segueix funcionant.

Documentació oficial de Shopify

Klaviyo

Crea una Private API Key de només lectura als ajustos de Klaviyo.

  1. 1A Klaviyo, prem el nom del teu compte (a baix a l'esquerra) i entra a «Settings» (Configuració).
  2. 2Obre la pestanya «API keys».
  3. 3Prem «Create Private API Key».
  4. 4Posa-li un nom que identifiqui l'app (p. ex. «Hablari»).
  5. 5Tria l'àmbit «Read-Only Key» (només lectura).
  6. 6Prem «Create» i copia a l'instant la clau que comença per pk_ (no es torna a mostrar).
  7. 7Enganxa aquesta clau a Hablari.

És la Private API Key (pk_…), no el Site ID públic de 6 caràcters. Es mostra una sola vegada; si t'equivoques de permisos, esborra-la i crea'n una altra. Necessites rol Owner, Admin o Manager a Klaviyo.

Documentació 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ó 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ó oficial de Recharge

Preguntes freqüents

Necessito coneixements tècnics per connectar un canal?

No. Cada guia està pensada per a gent no tècnica: crees l'app o aconsegueixes les credencials al proveïdor (WhatsApp, Instagram, Shopify…) i les enganxes a Configuració → Integracions. Hablari s'encarrega de la resta.

On enganxo les credencials?

Dins de Hablari, a Configuració → Integracions. Només el propietari de l'empresa pot connectar canals; les credencials es desen xifrades i mai no es tornen a mostrar.

Puc fer servir el meu número de WhatsApp actual?

Sí, amb la WhatsApp Cloud API fas servir un únic número per rebre i enviar. En migrar a l'API, aquest número deixa de fer-se servir a l'app del mòbil.

Encara no tens compte? Crea'l gratis i connecta el teu primer canal avui.

Centre d'ajuda: guies d'integració · Hablari