Configurar WhatsApp Business

1. Què demana la pàgina

A “Configuració Bàsica”, un “Nom de la Integració” i l'“Entorn”. A “Credencials”, quatre dades de Meta: l'“ID del número de telèfon” (pas 4), el “Token d'accés” (pas 5), el “Secret de l'aplicació” (pas 6) i el “Token de verificació del webhook”, que t'inventes tu (pas 7).

En desar amb “Desar Configuració” apareix “Provar Connexió”. Després, cada usuari activa WhatsApp a les seves preferències de notificació: l'enllaç “Vés a preferències de notificació” hi porta.

2. Passos 1 a 3: compte de Meta Business, verificació i app

Pas 1. Entra a business.facebook.com amb el teu compte de Facebook i crea un portafoli comercial (nom de l'empresa, el teu nom i un correu d'empresa).

Pas 2. A “Configuració del negoci → Centre de seguretat → Verificació del negoci”, puja el NIF i un justificant d'adreça. Meta triga 2-4 dies; sense verificar només pots enviar en mode de prova.

Pas 3. A developers.facebook.com → “Les meves apps” → “Crear app”, tria el cas d'ús “Connectar amb clients per WhatsApp”, posa-li nom i associa-la al teu portafoli.

3. Passos 4 a 6: número, token i secret de l'app

Pas 4. A “Configuració de l'API”, al desplegable “Des de”, prem “Afegir número de telèfon” i verifica'l per SMS o trucada. El número no pot tenir ja WhatsApp instal·lat. A sota apareix l'ID del número: copia'l a “ID del número de telèfon”.

Pas 5. El token de “Configuració de l'API” caduca en 24 h. A “Configuració del negoci → Usuaris del sistema” crea un usuari del sistema administrador, assigna-li l'app i el compte de WhatsApp, prem “Generar token” amb caducitat “Mai” i els permisos whatsapp_business_messaging, whatsapp_business_management i business_management. Copia'l (comença per EAA…) a “Token d'accés”: només es mostra una vegada.

Pas 6. A l'app de Meta, “Configuració → Bàsica”, prem “Mostrar” al costat de la clau secreta i copia-la a “Secret de l'aplicació”.

4. Passos 7 i 8: token de verificació i desar

Pas 7. Inventa't una cadena llarga i aleatòria (32 caràcters o més) i escriu-la a “Token de verificació del webhook”. La tornaràs a fer servir al pas 9 i ha de coincidir.

Pas 8. Prem “Desar Configuració” i després “Provar Connexió”. Si el token i el número són correctes, la integració passa a activa.

5. Pas 9: el webhook d'estat (recomanat)

Serveix perquè goPrevina sàpiga si cada missatge s'ha lliurat o s'ha llegit. A l'app de Meta, “WhatsApp → Configuració → Webhooks → Editar”. A “Callback URL” escriu https://<domini-de-la-teva-API>/api/v1/whatsapp/webhook i a “Verify token” el mateix valor del pas 7. Prem “Verificar i desar” i, a “Camps del webhook”, subscriu-te a messages.

6. Pas 10: plantilles de missatges per copiar i enganxar

WhatsApp només deixa enviar plantilles aprovades per Meta. Crea-les a WhatsApp Manager → “Plantilles de missatges” → “Crear plantilla”, amb el nom exacte i la categoria indicada, i enganxa el cos tal qual (els paràmetres {{1}}, {{2}}… van en l'ordre de la llista). Meta sol aprovar les de tipus UTILITY en 24-48 h.

prl_user_invitation — Categoria: UTILITY — Paràmetres: recipientName, tenantName, activationUrl

Cos per copiar: Hola {{1}}, t'han convidat a {{2}} a goPrevina. Activa el teu compte aquí: {{3}}

prl_password_reset — Categoria: AUTHENTICATION — Paràmetres: recipientName, resetUrl

Cos per copiar: Hola {{1}}, has sol·licitat restablir la contrasenya. Fes servir aquest enllaç: {{2}}

prl_critical_alert — Categoria: UTILITY — Paràmetres: alertTitle, alertMessage

Cos per copiar: ALERTA CRÍTICA: {{1}}. {{2}}

prl_document_expiring — Categoria: UTILITY — Paràmetres: documentName, expiryDate, daysRemaining

Cos per copiar: El document «{{1}}» caduca el {{2}} (queden {{3}} dies). Revisa'l a goPrevina.

prl_document_expired — Categoria: UTILITY — Paràmetres: documentName, expiryDate

Cos per copiar: El document «{{1}}» ha caducat el {{2}}. Actualitza'l a goPrevina.

prl_incident_reported — Categoria: UTILITY — Paràmetres: incidentNumber, title, location

Cos per copiar: Nou incident {{1}}: «{{2}}» a {{3}}. Consulta'l a goPrevina.

prl_incident_assigned — Categoria: UTILITY — Paràmetres: incidentNumber, title, assignedBy

Cos per copiar: T'han assignat l'incident {{1}}: «{{2}}» (per {{3}}). Obre'l a goPrevina.

prl_inspection_scheduled — Categoria: UTILITY — Paràmetres: inspectionTitle, scheduledDate, location

Cos per copiar: Inspecció programada: «{{1}}» el {{2}} a {{3}}.

prl_inspection_reminder — Categoria: UTILITY — Paràmetres: inspectionTitle, dueDate

Cos per copiar: Recordatori: la inspecció «{{1}}» venç el {{2}}.

prl_training_reminder — Categoria: UTILITY — Paràmetres: courseName, sessionDate, location

Cos per copiar: Recordatori de formació: «{{1}}» el {{2}} a {{3}}.

prl_medical_appointment — Categoria: UTILITY — Paràmetres: appointmentDate, appointmentTime, location

Cos per copiar: Tens cita de vigilància de la salut el {{1}} a les {{2}} a {{3}}.

prl_meeting_invitation — Categoria: UTILITY — Paràmetres: meetingTitle, meetingDate, organizer

Cos per copiar: Reunió: «{{1}}» el {{2}}, organitza {{3}}.

prl_notification — Categoria: UTILITY — Paràmetres: title, message

Cos per copiar: {{1}}: {{2}}

prl_generic — Categoria: UTILITY — Paràmetres: dynamic

Cos per copiar: {{1}}