.webp)
Per inviare messaggi WhatsApp utilizzando i modelli di incidente di Everbridge, non basta un'anteprima del messaggio. L'integrazione con ChatArchitect utilizza una variabile di incidente dedicata, denominata Codice WhatsApp, per identificare il modello WhatsApp approvato, quindi ne crea i parametri a partire dai valori inseriti nel modulo dell'operatore. I nomi dei campi, i numeri di sequenza e l'ordine dei parametri determinano la modalità di composizione del messaggio.
Questa guida spiega come configurare tale flusso di lavoro, utilizzando un pratico avviso di incidente a tre parametri. Illustra inoltre gli errori che possono modificare il messaggio finale: valori mancanti, variabili di incidente aggiuntive, un campo ID posizionato in modo errato e confusione tra l'ID del modello Everbridge e l'ID del modello WhatsApp.
Come Everbridge invia un modello WhatsApp tramite ChatArchitect
Il modello WhatsApp approvato fornisce il testo predefinito. Everbridge fornisce i valori specifici dell'incidente, come il luogo, la descrizione dell'evento e l'orario. ChatArchitect combina l'ID del modello WhatsApp con questi valori per preparare l'invio del messaggio.
Ad esempio, il modello approvato potrebbe recitare "Incidente a {{1}}: {{2}}. Segnalato alle {{3}}". Un operatore inserisce il luogo, l'evento e l'ora in variabili di incidente separate. Con la configurazione corretta, questi valori riempiono i tre segnaposto in ordine.
Questo articolo si concentra sul comportamento di creazione dei messaggi introdotto tra il 31 maggio e il 3 giugno 2025 per un'integrazione esistente tra Everbridge e ChatArchitect. Si tratta di una guida alla configurazione, non di una sostituzione della configurazione iniziale dell'integrazione. Per un'introduzione più ampia, leggi la nostra panoramica sull'integrazione dell'API WhatsApp Business con Everbridge.
Cosa ti serve prima di configurare il modello di incidente
Prima di modificare il modulo, preparare quanto segue:
- Un'integrazione Everbridge esistente connessa a ChatArchitect.
- Accesso all'organizzazione di riferimento nel portale Everbridge Manager e autorizzazione a modificare le variabili e i modelli relativi agli incidenti.
- Un modello di messaggio WhatsApp approvato, disponibile in ChatArchitect.
- L'ID esatto del modello WhatsApp, copiato con le relative parentesi graffe.
- Un elenco dei segnaposto del modello e del valore che ciascuno di essi dovrebbe ricevere.
- Il profilo di sottoscrizione delle risposte configurato per la tua integrazione.
- Destinatari di prova designati per il primo invio controllato.
Annota l'ordine dei segnaposto prima di iniziare a lavorare in Everbridge. Se {{1}} rappresenta il sito e {{2}} rappresenta l'evento, il modulo deve passare il valore del sito prima del valore dell'evento. Nomi di variabili chiari aiutano l'operatore, ma i nomi da soli non stabiliscono la mappatura dei parametri.
Passaggio 1: Copia l'ID del modello WhatsApp corretto
Apri l'applicazione ChatArchitect, scegli il modello WhatsApp approvato desiderato e copia il suo ID. Mantieni il valore copiato intatto, comprese le parentesi graffe. Incollerai questo valore nella variabile incidente denominata Codice WhatsApp.
Non sostituire l' ID del modello mostrato nell'intestazione del modello di incidente di Everbridge. Questo identifica il modello di Everbridge. Il codice WhatsApp richiede l'identificativo del modello di messaggio WhatsApp selezionato in ChatArchitect.
È fondamentale mantenere separati i ruoli dei due elementi di contenuto: l'ID seleziona il modello WhatsApp approvato; le variabili dell'incidente forniscono i relativi valori dei parametri. Modificare il testo del messaggio in uscita di Everbridge non è la stessa cosa che selezionare un modello WhatsApp diverso.
Passaggio 2: Creare le variabili dell'incidente
Nel portale Everbridge Manager, seleziona l'organizzazione appropriata e apri Comunicazioni → Incidenti → Variabili. Fai clic su Nuova variabile, seleziona Casella di testoe assegna alla variabile ID il nome esatto di Codice WhatsApp. Scegli un limite di caratteri adatto all'identificativo copiato, quindi fai clic su OK.
Crea o riutilizza una variabile per ogni parametro del modello WhatsApp. Nell'esempio di questa guida, usa Sito, Eventoe Ora. Ognuna dovrebbe contenere un singolo valore di testo semplice. Inserisci il nome di un edificio come Edificio A, ad esempio, invece di aggiungere manualmente le parentesi quadre attorno ad esso.
L'integrazione legge il primo valore di ciascuna variabile relativa agli incidenti. Una variabile a selezione multipla non genera automaticamente un parametro WhatsApp per ogni opzione selezionata. I campi a valore singolo semplificano la revisione della mappatura ed evitano tale ambiguità.
Passaggio 3: Aggiungere e ordinare i campi nel modulo dell'operatore
Apri Comunicazioni → Incidenti → Modelli e modifica il Modello di incidente pertinente. In Modulo e messaggio, inserisci il codice WhatsApp e tutte le variabili necessarie per il modello WhatsApp selezionato. Contrassegna i campi come obbligatori, in quanto un valore vuoto impedirebbe la corretta visualizzazione del messaggio.
Successivamente, apri ANTEPRIMA E MODIFICA → Modulo operatore. Controlla i numeri visualizzati accanto alle variabili e riordina i campi trascinandoli nella posizione desiderata.
Il codice WhatsApp e ogni parametro WhatsApp devono avere un numero di sequenza pari o superiore a 3. I campi al di sotto di tale soglia vengono ignorati per questo flusso di lavoro del modello. Posizionare il campo ID al terzo posto o successivamente, quindi inserire i campi dei parametri nell'ordine previsto dal modello approvato.
L'ordine dei campi visualizzato nel modulo è una guida utile, ma questa configurazione presuppone che corrisponda ai numeri di sequenza inviati dalla tua implementazione. Se un campo appare posizionato correttamente ma non compare nel risultato di WhatsApp, chiedi all'amministratore dell'integrazione di verificare i numeri di sequenza effettivi.
Il comportamento rivisto include anche i campi parametro idonei posizionati prima del Codice WhatsApp. Mantenere l'ID prima dei parametri rende il modulo più facile da esaminare, ma spostandolo non vengono rimossi gli altri campi idonei dall'elenco dei parametri.
Esempio completo di avviso di incidente a tre parametri
Supponiamo che il modello di messaggio WhatsApp approvato contenga questo testo:
Incidente a {{1}}: {{2}}. Segnalato a {{3}}.
Configura la sezione WhatsApp del modulo dell'operatore nel seguente ordine:
- Posizione 3 — Codice WhatsApp: {{your-template-id}}
- Posizione 4 — Sede: Edificio A
- Posizione 5 — Evento: Interruzione di corrente
- Posizione 6 — Tempo: 14:30
Il valore {{your-template-id}} è un esempio, non un ID da copiare. Sostituiscilo con l'identificativo esatto copiato dal tuo modello approvato in ChatArchitect.
L'integrazione crea la seguente stringa di invio:
{{your-template-id}} {{Edificio A}} {{Interruzione di corrente}} {{14:30}}
Il messaggio che si intende ricevere su WhatsApp è:
Incidente presso l'edificio A: interruzione di corrente. Segnalato alle 14:30.
L'operatore inserisce Edificio A, Interruzione di correntee 14:30 come testo semplice. L'integrazione aggiunge le parentesi del parametro durante l'assemblaggio del messaggio. Conservare le parentesi nell'ID del modello copiato, ma non aggiungerle manualmente ai normali valori dei parametri.
Passaggio 4: Verificare le impostazioni di invio e consegna dei messaggi
In Messaggi in uscita → Tutti i metodi di consegna , mantieni il contenuto del modello copiato da ChatArchitect, seguendo le istruzioni di configurazione dell'integrazione. Quindi rivedi le impostazioni del modello di incidente , seleziona WhatsApp come metodo di consegna e scegli il profilo di sottoscrizione alla risposta appropriato . Salva il modello.
Quando un campo Codice WhatsApp valido viene compilato, il modello WhatsApp inviato utilizza quell'ID e i valori del modulo. La sola modifica del testo del messaggio in uscita non modifica il modello WhatsApp selezionato o i relativi parametri. Per modificarli, è necessario aggiornare il Codice WhatsApp o le variabili dell'evento pertinenti.
Mantieni questa distinzione nelle istruzioni per gli operatori. Altrimenti, qualcuno potrebbe modificare l'anteprima in uscita e presumere che il destinatario di WhatsApp riceverà il testo modificato, anche se il modello approvato e i parametri forniti rimangono invariati.
Passaggio 5: Avvia un test controllato e ispeziona WhatsApp
Apri Comunicazioni → Incidenti → Avvia incidente, scegli il modello configurato e compila il modulo dell'operatore. Verifica l'ID del modello, ogni parametro e i destinatari prima di continuare.
Procedi con Avanti, rivedi i dettagli dell'incidente e le opzioni di invio, quindi utilizza Rivedi e invia. Il pulsante Rivedi dipende dalle impostazioni di revisione dell'organizzazione, pertanto il flusso di revisione esatto potrebbe variare.
Per il primo invio dopo una modifica del modello, seleziona destinatari di prova specifici. Confronta il messaggio WhatsApp effettivo con il risultato atteso: verifica la correttezza del testo, l'ordine dei parametri, l'ortografia e la completezza.
L'anteprima di Everbridge mostra il messaggio in uscita configurato in Everbridge. Non sostituisce la verifica del messaggio WhatsApp ricevuto. Considerare un test end-to-end riuscito come una fase di verifica separata prima di utilizzare il modulo modificato per le notifiche operative.
Quattro regole che impediscono la mappatura errata dei parametri
1. L'ordine dei campi determina i valori segnaposto
L'integrazione invia i valori idonei nell'ordine originale dei campi. Rinominare una variabile non sposta il suo valore in un altro segnaposto. Se il messaggio ricevuto inverte il sito e l'evento, verificare prima la sequenza del modulo.
2. I campi aggiuntivi compilati possono diventare parametri
Anche altre variabili relative agli incidenti con numeri di sequenza pari o superiori a 3 vengono incluse quando compilate. Esamina l'intero modulo, inclusi i campi non correlati a WhatsApp. Un valore aggiuntivo prima dei parametri desiderati può modificare il conteggio dei parametri o spostare la mappatura.
3. I valori vuoti vengono ignorati
Un campo vuoto non riserva una posizione di segnaposto vuota. I valori inseriti successivamente possono spostarsi in avanti. Nell'esempio precedente, lasciando vuoto il campo "Sito", "Interruzione di corrente" potrebbe occupare la prima posizione del parametro. È necessario compilare tutti i campi richiesti dal modello selezionato.
4. Il codice WhatsApp controlla il flusso di lavoro del modello
Se il codice WhatsApp è assente, vuoto o inferiore al numero di sequenza 3, l'integrazione utilizza il testo del messaggio in uscita di Everbridge e non aggiunge le altre variabili relative all'incidente. Questa descrizione si riferisce alla composizione del messaggio; non garantisce che un messaggio di fallback venga recapitato tramite WhatsApp. Per questo flusso di lavoro basato su modello, fornire sempre l'ID idoneo corretto.
Risoluzione dei problemi relativi ai messaggi del modello WhatsApp di Everbridge
Nel segnaposto sono presenti informazioni errate. Confronta l'ordine dei parametri con il modello approvato. Verifica la presenza di valori vuoti e di campi idonei aggiuntivi compilati prima di modificare il testo del modello.
Nel messaggio manca un campo. Verificare che contenga un valore, che sia presente nel modulo dell'operatore e che abbia un numero di sequenza effettivo di almeno 3. Se si tratta di una variabile a selezione multipla, ricordare che viene letto solo il suo primo valore.
L'integrazione utilizza il testo in uscita anziché la stringa del modello prevista. Verifica il nome esatto della variabile "WhatsApp Code", il suo ID copiato e il suo numero di sequenza. Non utilizzare l'ID dell'intestazione del modello di incidente di Everbridge.
L'anteprima di Everbridge sembra corretta, ma WhatsApp è diverso. Esamina il codice di WhatsApp e i valori del modulo. Un ID valido e compilato seleziona il modello di WhatsApp indipendentemente dalle modifiche apportate al testo in uscita.
Il messaggio WhatsApp previsto non è arrivato. Ricontrolla il metodo di consegna selezionato, il profilo di integrazione, i destinatari e il modello approvato, oltre alla configurazione del modulo. La sola corretta configurazione dei parametri non garantisce il corretto invio del messaggio.
Domande frequenti
Qual è il codice WhatsApp a Everbridge?
Si tratta della variabile incidente utilizzata dall'integrazione di ChatArchitect per contenere l'ID del modello di messaggio WhatsApp. Il suo nome deve essere esattamente "Codice WhatsApp" e il suo numero di sequenza deve essere 3 o superiore.
Devo racchiudere i valori degli incidenti tra parentesi graffe?
No. Inserisci i valori dei parametri come testo semplice. L'integrazione aggiungerà le parentesi. L'ID del modello è diverso: conserva le parentesi esattamente come copiate da ChatArchitect.
I campi dei parametri possono precedere il codice WhatsApp?
Sì. Il comportamento rivisto include i campi parametro non vuoti idonei anche quando precedono l'ID. I loro numeri di sequenza devono comunque essere pari o superiori a 3 e il loro ordine deve corrispondere ai segnaposto del modello.
La modifica del messaggio in uscita seleziona un modello diverso?
No, quando è già presente un codice WhatsApp valido. Modifica quell'ID per selezionare un altro modello approvato, quindi rivedi il numero e l'ordine dei suoi parametri.
Cosa devo aggiornare in un modello di incidente obsoleto?
Aggiungi o compila il codice WhatsApp, includi tutte le variabili di parametro richieste e verifica i loro numeri di sequenza e l'ordine. L'integrazione rivista mantiene un fallback in testo semplice. ChatArchitect ha annunciato separatamente un requisito di ID per gli invii tramite modello a partire dal 1° agosto 2025; copia sempre l'ID corretto per il flusso di lavoro del modello descritto qui.
Prepara il tuo flusso di lavoro WhatsApp di Everbridge con ChatArchitect
Una configurazione affidabile del modulo inizia con un ID del modello preciso e una sequenza di parametri prevedibile. Il compito dell'operatore deve essere chiaro: selezionare il modello desiderato, compilare tutti i campi obbligatori, verificare i destinatari e controllare il messaggio ricevuto dopo le modifiche alla configurazione.
Utilizza la guida di configurazione del template Everbridge di ChatArchitect come riferimento. Se stai pianificando l'integrazione, consulta i piani relativi all'API WhatsApp Business di ChatArchitect e prepara un messaggio di esempio per la gestione degli incidenti con i campi necessari al tuo team.
