Registrazione su Twilio

Visita www.twilio.com/try-twilio e completa il processo di registrazione.

Durante la registrazione, ti verrà richiesto di:

• Fornire un indirizzo email valido
• Creare una password sicura
• Verificare il tuo numero di telefono tramite SMS o chiamata

Accesso alla Console Twilio

Dopo la registrazione, accedi alla Console Twilio che sarà il tuo punto di controllo per tutti i servizi Twilio.

Nella console troverai:

• Account SID e Auth Token (necessari per l'autenticazione)
• Dashboard con informazioni sull'utilizzo e i costi
• Accesso a tutti i prodotti e servizi Twilio

Importante: L'Account SID e l'Auth Token sono le "chiavi" che ti permetteranno di integrare Twilio con la nostra piattaforma. Prendine nota in un luogo sicuro.

Configurazione del metodo di pagamento

Per utilizzare i servizi Twilio oltre ai crediti di prova, devi impostare un metodo di pagamento.

1. Nella Console Twilio, vai a "Billing" nel menu laterale
2. Seleziona "Manage Billing"
3. Aggiungi un metodo di pagamento (carta di credito)
4. Completa le informazioni di fatturazione

Twilio utilizza un modello di pagamento a consumo, quindi pagherai solo per i messaggi effettivamente inviati e ricevuti.

Accesso alla sezione WhatsApp

Nella Console Twilio:

1. Vai a "Messaging" nel menu laterale
2. Seleziona "WhatsApp"
3. Clicca su "Manage" o "Gestisci"

Richiesta di un numero WhatsApp dedicato

Per richiedere un numero dedicato per WhatsApp Business:

1. Clicca su "Request a WhatsApp Number" o "Richiedi un numero WhatsApp"
2. Seleziona il paese in cui opererà principalmente il tuo business
3. Scegli tra le opzioni di numeri disponibili
4. Conferma l'acquisto

Il costo del numero varia in base al paese selezionato e al tipo di numero scelto (locale, toll-free, ecc.).

Attivazione della eSIM

Una volta acquisito il numero:

1. Twilio ti guiderà attraverso il processo di attivazione della eSIM
2. Dovrai fornire le informazioni dell'azienda per la verifica
3. Accetta i termini e le condizioni di WhatsApp Business
4. Attendi la conferma dell'attivazione (può richiedere fino a 24-48 ore)

Accesso a Meta Business

Twilio ti guiderà attraverso il processo di connessione con Meta Business:

1. Nella sezione WhatsApp di Twilio, dopo aver acquisito un numero, clicca su "Connect with Meta"
2. Verrai reindirizzato alla pagina di login di Meta Business
3. Se non hai ancora un account Meta Business, ti verrà chiesto di crearne uno

Verifica dell'identità aziendale

Meta richiede una verifica dell'identità per le aziende che utilizzano WhatsApp Business API:

1. Fornisci i dettagli completi della tua azienda (nome legale, indirizzo, partita IVA)
2. Carica i documenti richiesti per la verifica (es. visura camerale, documento d'identità)
3. Indica il settore in cui opera la tua azienda
4. Fornisci il sito web aziendale (deve essere attivo e funzionante)

Il processo di verifica può richiedere da alcuni giorni a qualche settimana, in base alla complessità della verifica.

Configurazione del profilo aziendale

Una volta completata la verifica:

1. Configura il profilo aziendale su WhatsApp Business
2. Carica il logo dell'azienda (dimensione consigliata: 640x640 pixel)
3. Aggiungi una descrizione dell'azienda
4. Inserisci gli orari di attività, se pertinenti
5. Aggiungi il sito web e l'indirizzo email di contatto

Queste informazioni saranno visibili ai tuoi clienti quando interagiscono con il tuo account WhatsApp Business.

Configurazione delle autorizzazioni

Per consentire a Twilio di inviare messaggi per conto della tua azienda:

1. Nella dashboard di Meta Business, vai alla sezione "Integrazioni WhatsApp"
2. Trova Twilio nell'elenco dei provider e verifica che sia correttamente collegato
3. Concedi a Twilio le autorizzazioni necessarie per gestire i messaggi
4. Conferma la configurazione

Accesso alla sezione template

Nella Console Twilio:

1. Vai a "Messaging" nel menu laterale
2. Seleziona "Content" e poi "WhatsApp Templates"

Creazione di un nuovo template

Clicca su "Create a Template" e segui questi passi:

1. Seleziona la categoria del template (marketing, utility, autenticazione, ecc.)
2. Scegli la lingua del template
3. Dai un nome al template (solo per riferimento interno)
4. Componi il messaggio rispettando le linee guida di WhatsApp
5. Aggiungi eventuali parametri variabili tra parentesi graffe {{nome_parametro}}
6. Invia il template per l'approvazione

Linee guida per i template

Per aumentare le probabilità di approvazione:

• Evita contenuti promozionali aggressivi
• Non includere riferimenti ad armi, gioco d'azzardo, alcol o farmaci
• Mantieni un tono professionale e rispettoso
• Assicurati che il messaggio sia pertinente alla categoria scelta
• Non includere URL abbreviati o codici QR

Il processo di approvazione può richiedere da alcune ore a qualche giorno.

Struktura dei template

WhatsApp supporta diversi tipi di template con vari componenti:

• Intestazione: può contenere testo, immagini, documenti o video
• Corpo: il testo principale del messaggio, può includere parametri variabili
• Piè di pagina: testo aggiuntivo sempre uguale per tutti i destinatari
• Pulsanti: fino a 3 pulsanti per azioni rapide (URL, chiamate, risposte rapide)

Per una maggiore versatilità, è consigliabile creare template con parametri variabili (come {{1}} o {{nome}}) che potrai personalizzare durante l'invio.

Configurazione delle impostazioni aziendali

Dopo aver effettuato l'accesso alla piattaforma:

1. Dalla dashboard, clicca su "Impostazioni Azienda" o naviga direttamente a "company_settings.php"
2. Compila i campi relativi alle informazioni generali della tua azienda
3. Trova la sezione dedicata alle credenziali Twilio

Inserisci le seguenti credenziali Twilio:

• Twilio SID: Il tuo Account SID (inizia con "AC...")
• Twilio Token: Il tuo Auth Token
• Numero Twilio: Il tuo numero WhatsApp in formato "whatsapp:+1234567890"

Questi dati si trovano nella Dashboard di Twilio sotto "Account Info".

Configurazione dei template

Per utilizzare i template approvati da WhatsApp nella nostra piattaforma:

1. Dalla dashboard, clicca su "Gestione Template" o naviga a "template.php"
2. Clicca su "Nuovo Template"

Per ogni template, dovrai inserire:

• Nome Template: Un nome descrittivo per identificare il template
• Template SID Twilio: Il codice SID fornito da Twilio (inizia con "HX...")
• Descrizione: Una breve descrizione dell'uso previsto
• Contenuto Template con Variabili: Il testo esatto del template, incluse le variabili
• Supporto per allegati: Seleziona questa opzione se il template è stato approvato per l'invio di media

Segui attentamente le linee guida fornite nella pagina template.php per garantire che i template funzionino correttamente.

Test dell'integrazione

Prima di utilizzare il sistema in produzione, è fondamentale testare l'integrazione:

1. Dalla dashboard, vai alla sezione "Elenco Conversazioni"
2. Aggiungi un contatto di test (preferibilmente il tuo numero personale)
3. Invia un messaggio di test utilizzando uno dei template configurati
4. Verifica che il messaggio venga ricevuto correttamente sul dispositivo

Se riscontri problemi, controlla i seguenti elementi:

• Verifica che le credenziali Twilio siano corrette
• Assicurati che il formato del numero WhatsApp sia corretto (deve includere "whatsapp:" seguito dal prefisso internazionale)
• Controlla che il template SID sia inserito correttamente
• Verifica che il contenuto del template corrisponda esattamente a quello approvato

Configurazione delle funzionalità avanzate

Una volta verificata l'integrazione di base, puoi configurare funzionalità avanzate:

• Autorisposte: Configura risposte automatiche in base a parole chiave o orari
• Pianificazione Messaggi: Programma l'invio di messaggi in date e orari specifici
• Assistente AI: Configura l'assistente AI per rispondere automaticamente alle domande frequenti
• Gestione Gruppi: Organizza i contatti in gruppi per comunicazioni mirate

Queste funzionalità sono accessibili dalle rispettive sezioni della dashboard.