CONFIGURAZIONE TOOL WHATSAPP BUSINESS

Configurazione per l'invio di notifiche automatiche tramite WhatsApp Business API

PANORAMICA DEL TOOL

Funzionalità Principali
Il tool WhatsApp Business permette ad AI4CALL di inviare notifiche automatiche ai clienti tramite la WhatsApp Business API di Meta, garantendo una comunicazione professionale e tempestiva.
Vantaggi dell'integrazione:
• Notifiche istantanee: I messaggi raggiungono immediatamente i clienti
• Alta leggibilità: 98% dei messaggi WhatsApp vengono letti entro 3 minuti
• Template approvati: Messaggi professionali conformi alle policy Meta
• Modalità Test: Prova il servizio con 10 invii gratuiti
• Tracciamento consegne: Monitoraggio stato di ogni messaggio
Modalità Test
Quando è attivata la "Modalità Test", puoi utilizzare il nostro account WhatsApp Business e i nostri template pre-approvati per inviare fino a 10 messaggi di prova.
Vantaggi della Modalità Test:
• Non richiede configurazione immediata del tuo account
• Template pronti all'uso per diverse tipologie di messaggio
• Possibilità di testare l'integrazione prima dell'attivazione completa
• Nessun costo aggiuntivo per i primi 10 invii

DATI RICHIESTI PER LA CONFIGURAZIONE

Access Token (Bearer) *
Token di accesso permanente generato dalla tua app Meta Developer per autenticare le chiamate alla WhatsApp Business API.
Formato: Stringa alfanumerica lunga (esempio: EAAG...XYZ)
Durata: Permanente (non scade automaticamente)
Permessi: whatsapp_business_messaging, whatsapp_business_management
Phone Number ID *
Identificativo numerico del numero di telefono WhatsApp Business registrato nella tua app Meta Developer.
Formato: ID numerico (esempio: 1234567890123456)
Dove trovarlo: Meta for Developers > WhatsApp > API Setup
Nota: Diverso dal numero di telefono effettivo
Template Name *
Nome del template di messaggio pre-approvato da WhatsApp che sarà utilizzato per inviare le notifiche ai clienti.
Formato: Solo caratteri minuscoli, numeri e underscore
Esempi: appointment_reminder, order_confirmation, welcome_message
Stato: Deve essere approvato da WhatsApp prima dell'uso

PROCEDURA DI CONFIGURAZIONE COMPLETA

Prerequisiti
Prima di iniziare la configurazione, assicurati di avere:
Requisiti necessari:
• Un'attività commerciale legalmente registrata
• Un sito web aziendale attivo
• Un numero di telefono non utilizzato su WhatsApp personale
• Account Meta Business Manager verificato
• Conformità alle Policy di WhatsApp Business
Guida Passo-Passo
Segui questa procedura per configurare la WhatsApp Business API:
Creazione Account Meta Developer
Accedi a developers.facebook.com e crea un account sviluppatore Meta se non lo possiedi già. Verifica la tua identità seguendo le istruzioni fornite da Meta.
Configurazione Meta Business Manager
Visita business.facebook.com e crea o configura il tuo account Business Manager. Verifica l'account aziendale fornendo i documenti richiesti da Meta.
Creazione App Business
Nel dashboard Meta for Developers, crea una nuova app di tipo "Business". Aggiungi il prodotto WhatsApp alla tua app e configura i dettagli base (Privacy Policy, Terms of Service, App Mode: Live).
Configurazione WhatsApp API
Nella sezione WhatsApp della tua app, seleziona il tuo Business Manager account, aggiungi e verifica il numero di telefono business. Configura i webhook per ricevere notifiche sui messaggi.
Generazione Access Token
Vai in Business Settings > Users > System Users nel tuo Business Manager. Crea un nuovo System User con ruolo Admin, quindi genera un token permanente con i permessi whatsapp_business_messaging e whatsapp_business_management.
Recupero Phone Number ID
Nel dashboard della tua app Meta, vai su WhatsApp > API Setup. Qui troverai il Phone Number ID associato al tuo numero business registrato.
Creazione Template Messaggi
Nella sezione WhatsApp Manager o tramite API, crea i template di messaggio necessari per le tue notifiche. Ogni template deve essere approvato da WhatsApp prima dell'utilizzo (processo che richiede solitamente 24 ore).
Test e Configurazione Tool
Una volta ottenuti Access Token, Phone Number ID e template approvati, inserisci questi dati nel tool AI4CALL e attiva la modalità test per verificare che tutto funzioni correttamente.

CREAZIONE E APPROVAZIONE TEMPLATE

Che cosa sono i Template
I template sono messaggi pre-strutturati che WhatsApp deve approvare prima che tu possa inviarli ai clienti. Servono per garantire qualità e prevenire spam sulla piattaforma.
Caratteristiche dei template:
• Contenuto fisso con variabili personalizzabili
• Categorie specifiche (Marketing, Utility, Authentication)
• Approvazione obbligatoria da parte di WhatsApp
• Monitoraggio qualità basato su feedback utenti
Linee Guida per l'Approvazione
Per aumentare le possibilità di approvazione del tuo template:
Best Practices:
• Contenuto chiaro: Messaggio comprensibile e specifico
• Categoria corretta: Scegli la categoria appropriata al contenuto
• Variabili ben posizionate: Non all'inizio o fine del messaggio
• Lingua appropriata: Tono professionale ma amichevole
• Opt-in necessario: Invia solo a utenti che hanno dato consenso
• Conformità policy: Rispetta le policy di WhatsApp Business
Esempio di Template
Ecco un esempio di template ben strutturato per promemoria appuntamenti:
**Nome Template:** appointment_reminder
**Categoria:** Utility
**Contenuto:**

Ciao {{1}}! 👋

Ti ricordiamo il tuo appuntamento con {{2}} previsto per {{3}} alle ore {{4}}.

📍 Presso: {{5}}
📞 Per info: {{6}}

Rispondi con "OK" per confermare o "ANNULLA" per disdire.

Grazie!
*{{7}}*
Processo di Approvazione
Il processo di revisione da parte di WhatsApp segue questi tempi:
Tempistiche di approvazione:
• Revisione standard: Entro 24 ore
• Revisioni complesse: Fino a 7 giorni lavorativi
• Modifiche richieste: Possibile richiesta di correzioni
• Notifiche: Aggiornamenti via email e webhook
• Stato "Quality Pending": Monitoraggio qualità post-approvazione

RISOLUZIONE PROBLEMI COMUNI

Errori di Autenticazione
Se ricevi errori di accesso negato o token non valido:
Possibili soluzioni:
• Verifica che l'Access Token sia ancora valido
• Controlla che i permessi includano whatsapp_business_messaging
• Assicurati che l'app sia in modalità "Live" e non "Development"
• Verifica che il Business Manager sia verificato
Template Rifiutato
Se il tuo template viene rifiutato da WhatsApp:
Azioni correttive:
• Leggi attentamente il feedback di rifiuto
• Rimuovi contenuto promozionale eccessivo
• Correggi il posizionamento delle variabili
• Semplifica il linguaggio e rendi il messaggio più chiaro
• Assicurati che la categoria sia appropriata
Messaggi Non Consegnati
Se i messaggi non raggiungono i destinatari:
Controlli da effettuare:
• Verifica che il numero destinatario sia su WhatsApp
• Controlla i limiti di invio giornalieri
• Assicurati che il template sia ancora attivo
• Verifica la qualità del template (non sospeso)
• Controlla che il numero mittente sia verificato

LIMITI DI INVIO E COSTI

Limiti di Messaging
WhatsApp applica limiti progressivi basati sulla qualità del tuo account:
Livelli di limite giornaliero:
• Livello 1: 250 conversazioni uniche nelle 24h
• Livello 2: 1.000 conversazioni uniche nelle 24h
• Livello 3: 10.000 conversazioni uniche nelle 24h
• Livello 4: 100.000 conversazioni uniche nelle 24h
• Illimitato: Raggiungibile con account di alta qualità
Modello di Costi
WhatsApp utilizza un modello di pricing basato su conversazioni:
Struttura tariffaria (prezzi indicativi in EUR):
• Conversazioni Utility: €0.0047 - €0.0055
• Conversazioni Authentication: €0.0028 - €0.0037
• Conversazioni Marketing: €0.0165 - €0.0300
• Conversazioni Service: Gratuite se iniziate dal cliente
I prezzi variano per paese e sono soggetti a modifiche da parte di Meta

RISORSE E DOCUMENTAZIONE UFFICIALE

Link Utili Meta/WhatsApp
Documentazione e risorse ufficiali per approfondimenti:
Risorse principali:
• WhatsApp Business Platform - Meta for Developers
• Meta Business Manager
• WhatsApp Business Policy
• Pricing WhatsApp Business Platform
• WhatsApp Business API - Guida Setup
Supporto Tecnico
Per supporto tecnico e assistenza nella configurazione:
Canali di supporto:
• Supporto AI4CALL: Assistenza diretta per l'integrazione
• Meta Business Support: Per problemi di account e API
• WhatsApp Business API Documentation: Guide tecniche dettagliate
• Community Developer: Forum e gruppi di supporto
Supporto Tecnico Dedicato

Il team BEEVOIP è sempre disponibile per assistenza nella configurazione del tuo assistente AI.
Ogni configurazione predefinita è stata ottimizzata per garantire le migliori performance.

Configurazione Sicura Setup Rapido Personalizzabile