Documentació de WhatsBoost

Què és WhatsBoost?

WhatsBoost és la plataforma d'ALMC que converteix el teu número de WhatsApp en un canal complet d'atenció i vendes: un chatbot amb IA respon els teus clients 24/7, reserva cites, cobra comandes i desa cada contacte en un CRM. No cal programar, ni instal·lar res, ni canviar de número.

Funciona amb el teu WhatsApp de sempre (normal o Business) vinculat per codi QR, igual que WhatsApp Web. Tot es gestiona des d'un panell al navegador, amb aquests mòduls inclosos:

Mòduls inclosos

Com començo a fer servir WhatsBoost?

Crear el compte és gratis i en menys de 5 minuts pots tenir el chatbot funcionant: registra't, connecta el teu número de WhatsApp escanejant un codi QR i explica-li a la IA a què es dedica el teu negoci. No calen coneixements tècnics.

1. Crea el teu compte gratisRegistra't amb el teu email. El pla bàsic és gratuït per sempre i sense permanència: ideal per provar amb clients reals.
2. Connecta el teu WhatsAppEscaneja el codi QR del panell des del mòbil, igual que faries amb WhatsApp Web. El detall complet és a la secció següent.
3. Configura el chatbot amb IAExplica-li el teu negoci en llenguatge normal: què vens, horaris, preus, adreça. Amb això la IA ja respon les preguntes habituals per tu.
4. Convida el teu equip (opcional)Afegeix les persones que atenen el WhatsApp per treballar plegades a la safata compartida, cadascuna amb el seu accés.

Consell: comença amb el pla gratis, deixa el bot responent uns dies i revisa l'analítica. Sabràs exactament què t'aporta abans de plantejar-te ampliar.

Comença gratis

Com connecto el meu número de WhatsApp?

WhatsBoost es vincula al teu WhatsApp igual que WhatsApp Web: al mòbil obre WhatsApp → Configuració → Dispositius vinculats → Vincular un dispositiu, i escaneja el codi QR que mostra el panell. Serveix tant WhatsApp normal com WhatsApp Business, i el teu número no canvia.

1. Entra al panell de WhatsBoost i obre la secció de connexió de números.
2. Al mòbil: WhatsApp → Configuració → Dispositius vinculats → Vincular un dispositiu.
3. Escaneja el codi QR que apareix a la pantalla.
4. Quan l'estat passi a «connectat», ja pots rebre i enviar des del panell.

I si es desconnecta?

Com a WhatsApp Web, la sessió depèn que el mòbil tingui bateria i internet. Si es talla, el panell t'ho indica i n'hi ha prou amb tornar a escanejar el QR per reconnectar; les converses, contactes i configuració no es perden.

Diversos números

Segons el teu pla pots connectar més d'un número i configurar cadascun per separat: horaris d'enviament, comportament del bot i ritme de campanyes independents.

Safata d'entrada per a equips

Totes les converses del teu WhatsApp arriben a una safata compartida tipus xat: el teu equip respon des del panell, les converses s'assignen entre agents i el client segueix parlant amb el teu número de sempre, sense notar res.

• Diversos agents alhora sobre el mateix número, cadascun amb el seu usuari.
• Assignació de converses: qui atén què, sense trepitjar-se.
• Respostes desades per contestar allò repetitiu en dos clics.
• Historial complet del contacte al costat del xat: comandes, notes del CRM i converses anteriors.
• Enviament de text, imatges, documents i notes de veu — fins i tot àudio generat amb IA a partir de text.

Com envio campanyes massives sense que em bloquegin el número?

Crea la campanya, tria els contactes i WhatsBoost envia els missatges a poc a poc, amb pauses i dins de l'horari que defineixis. Aquest control de velocitat imita l'enviament humà i és la millor protecció contra bloquejos; a més, les baixes (STOP) es gestionen soles.

1. Prepara l'audiència: importa contactes o segmenta els que ja tens al CRM.
2. Redacta el missatge amb variables (nom, empresa…) perquè cada enviament sigui personal. Pots adjuntar imatges o documents.
3. Configura el ritme d'enviament i la franja horària. Si la campanya no hi cap, continua sola l'endemà.
4. Llança-la al moment o programa-la, i segueix lliuraments i respostes des de l'analítica de la campanya.

Baixes automàtiques (STOP)

Si un contacte respon STOP (o la paraula de baixa que configuris), entra a la llista de supressió i no torna a rebre campanyes. Compleixes el RGPD sense portar llistes a mà.

Bones pràctiques anti-bloqueig

• Escriu només a persones que et coneixen i han donat el seu consentiment.
• Amb un número acabat de connectar, comença amb pocs enviaments i puja el ritme gradualment.
• Personalitza amb variables: centenars de missatges idèntics són el senyal d'spam més obvi.
• Respecta els horaris comercials; ningú no vol ofertes a les 3 de la matinada.
• Mantén el ritme conservador que porta per defecte el teu pla: està pensat per protegir el teu número.

Com funciona el chatbot amb IA?

Li expliques a què es dedica el teu negoci (serveis, horaris, preus, adreça) i la IA respon a l'instant les preguntes dels teus clients, en el seu idioma i amb el teu to. Quan la conversa necessita una persona, el teu equip la continua en manual des de la safata.

A més de la IA, tens automatitzacions clàssiques que es disparen soles:

• Missatge de benvinguda el primer cop que algú t'escriu.
• Resposta d'absència fora del teu horari d'atenció.
• Respostes per paraula clau («preu», «horari», «cita»…).
• Protecció anti-bucle: si qui escriu és un altre bot, WhatsBoost talla la conversa en lloc de contestar-se eternament.

Tu marques el límit per número: encén o apaga el bot quan vulguis, dona-li un missatge de recanvi per quan no sàpiga respondre, i decideix amb el «mode agent» si a més de contestar pot executar accions — crear cites i sol·licituds de cobrament — de manera autònoma. El teu equip sempre pot entrar des de la safata i respondre en manual.

CRM: contactes i embuts de venda

Cada persona que t'escriu queda desada com a contacte amb el seu historial complet. Les oportunitats es mouen per les etapes del teu embut en un tauler kanban, així cap venda no es queda a mitges per oblit.

• Contactes creats automàticament des de les converses.
• Embuts personalitzables per etapes, en tauler kanban arrossegable.
• Cada oportunitat enllaça amb la seva conversa de WhatsApp: context complet en un clic.
• Recordatoris de seguiment per reprendre a temps les vendes pendents.

Com venc i cobro per WhatsApp?

Puja els teus productes al catàleg, comparteix-los al xat i converteix la conversa en comanda: el client rep un enllaç de pagament i tu veus la comanda al panell. Si treballes amb cites, la reserva i la confirmació també van soles per WhatsApp.

• Catàleg de productes amb foto, preu i descripció, a punt per compartir al xat.
• Comandes registrades al panell, amb el seu estat i la seva conversa associada.
• Enllaços de pagament per cobrar sense sortir de WhatsApp.
• Reserva de cites amb confirmació automàtica, gestionada pel bot o des del panell.

Estats de WhatsApp des del panell

Publica estats (les «històries» de WhatsApp) directament des de WhatsBoost, sense agafar el mòbil, i consulta en un mur de només lectura els estats que publiquen els teus contactes.

Els estats són l'aparador més barat que tens: caduquen sols al cap de 24 hores i els veuen els contactes que ja et tenen desat — just l'audiència més calenta.

Analítica i informes

Mesura què passa al teu WhatsApp: missatges enviats i rebuts, lliuraments, resultats per campanya i activitat per període. Tot es pot exportar a CSV quan ho necessitis.

Cada campanya desa el seu historial d'enviaments, així pots comparar quins missatges funcionen millor abans de repetir una promoció.

API i integracions

WhatsBoost inclou una API amb clau per compte per enviar missatges de WhatsApp des de les teves pròpies aplicacions, i mòduls oficials per a PrestaShop i WordPress que avisen automàticament els teus clients de l'estat de la seva comanda.

• Clau d'API personal, visible a la secció API del teu panell.
• Mòdul per a PrestaShop: missatges automàtics per estat de la comanda.
• Plugin per a WordPress / WooCommerce: avisos i botó de xat.

Autenticació

Crea la teva clau al panell (WhatsBoost → API → «Crear clau»). La clau es mostra una sola vegada, comença per wbk_live_ i s'envia a la capçalera Authorization de cada petició:

Authorization: Bearer wbk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Endpoints disponibles

• GET /api/v1/whatsboost/sessionsLlista els teus números connectats (id, etiqueta, telèfon, estat).
• POST /api/v1/whatsboost/messagesEncua un missatge de text. Respon 202 a l'instant i el lliurament real respecta el ritme anti-bloqueig del número.
• GET /api/v1/whatsboost/messagesHistorial de missatges, filtrable per número (session_id) o conversa (chat); fins a 200 per petició.
• GET /api/v1/whatsboost/groups?session_id=…Llista els grups d'un número amb el seu jid; fes servir aquest jid com a destinatari per enviar a un grup.

Exemple: enviar un missatge

curl -X POST https://almc.es/api/v1/whatsboost/messages \
  -H "Authorization: Bearer wbk_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"session_id": TU_SESSION_ID, "to": "34600111222", "text": "Hola desde la API 👋"}'

HTTP/1.1 202 Accepted
{"id": 12345, "queued": true}

El 202 amb queued:true vol dir «acceptat i en cua»: el lliurament respecta el ritme del número (els acabats de connectar envien més a poc a poc, per protegir-los) i els límits del teu pla. Pots afegir una capçalera Idempotency-Key per reintentar una petició sense risc de duplicar l'enviament.

Substitueix TU_SESSION_ID pel número de la teva sessió: és el camp «id» que retorna aquesta crida, i apareix a la columna «ID per a l'API» de la pantalla Sessions. No és el telèfon.

Errors que pots rebre

• 401 — clau absent, invàlida o revocada.
• 404 — el número (session_id) no existeix o no pertany al teu compte.
• 422 — destinatari invàlid o quota del pla superada (la resposta indica el motiu i el límit).
• 429 — massa peticions: l'API té límit de ritme per clau i per compte.
• 409 — (grups) aquest número no està connectat en aquest moment.

Plans, límits i comptes

El pla bàsic és gratis per sempre i inclou l'essencial per començar. Els plans de pagament amplien límits d'enviament, números connectats i mòduls avançats, i pots canviar o cancel·lar quan vulguis des del panell.

Els preus i què inclou cada pla estan sempre actualitzats a la pàgina de preus. Veure plans i preus