El connector de WhatsApp Business permet que l'assistent d'IA i els workflows de la teva organització enviïn missatges de WhatsApp directament amb l'API oficial de Meta, sense serveis intermediaris. És un connector d'organització: el dona d'alta un administrador a l'àrea de Connectors, i el número de telèfon des del qual s'envia pertany a l'organització.

Dues regles de WhatsApp que convé entendre abans de començar:

  • Text lliure només dins la finestra de 24 hores: pots enviar qualsevol text a una persona que t'ha escrit en les últimes 24 hores.
  • Plantilles per iniciar converses: fora d'aquesta finestra, només pots enviar plantilles pre-aprovades per Meta. Per això el connector té dues eines d'enviament separades.

Part 1 — Prepara el costat de Meta (administrador, un cop)

No et cal cap compte de WhatsApp Business previ per començar: Meta te'n crea un de prova en donar d'alta l'aplicació.

  1. Entra a developers.facebook.com amb un compte de Facebook i crea un compte de desenvolupador (gratuït).
  2. Crea una aplicació de tipus Business i afegeix-hi el producte WhatsApp. En fer-ho, Meta aprovisiona automàticament un compte de WhatsApp Business de prova amb un número de prova.
  3. A la pàgina WhatsApp → API Setup hi trobaràs les dues dades que Yellow necessita:
    • L'identificador del número de telèfon (Phone number ID — un número llarg, no el telèfon).
    • Un token d'accés. El de la pàgina és temporal (24 hores), suficient per provar. Per a ús real, crea un system user al Business Manager (Configuració del negoci → Usuaris → Usuaris del sistema), assigna-li l'aplicació i genera-li un token permanent amb el permís whatsapp_business_messaging.
  4. Amb el número de prova pots enviar missatges a un màxim de 5 números destinataris que verifiquis per SMS des de la mateixa pàgina — ideal per provar sense cap cost.

Per passar a producció més endavant: un número de telèfon propi que no estigui actiu al WhatsApp normal, la revisió del nom visible, i les plantilles que vulguis aprovades per Meta. Meta cobra per conversa iniciada per l'empresa (les converses de servei — respondre dins les 24 hores — són gratuïtes).

Part 2 — Dona d'alta el connector a Yellow

  1. A l'àrea d'organització, obre Connectors → Nou connector → Catàleg → WhatsApp Business.
  2. Introdueix l'ID del número de telèfon de la Part 1.
  3. Enganxa el token al camp de credencial (es desa de manera segura i no es torna a mostrar; per canviar-lo, torna a enganxar-ne un de nou).
  4. Desa i fes servir Prova la connexió — llegeix el perfil del número per confirmar que el token i el número són correctes.
  5. Activa Disponible a workflows i rutines si vols que els workflows enviïn missatges.

Les eines

Eina Què fa Quan es pot fer servir
whatsapp_send_message text lliure dins la finestra de 24 h
whatsapp_send_template plantilla aprovada (amb paràmetres) sempre; inicia converses
whatsapp_get_business_profile llegeix el perfil del número la prova de connexió

Amb el número de prova, la plantilla hello_world ja ve aprovada — és la manera més ràpida de veure un missatge arribar.

Resolució de problemes

  • «token expired» o similar — el token temporal de 24 h ha caducat; genera'n un de permanent amb un system user (Part 1, pas 3).
  • El destinatari no rep res (número de prova) — el seu telèfon ha d'estar a la llista de destinataris verificats de la pàgina API Setup.
  • «template not found» — el nom o l'idioma de la plantilla no coincideix amb cap plantilla aprovada del compte.
  • Error en text lliure — probablement ets fora de la finestra de 24 h; fes servir una plantilla.

Relacionats