Messaggi e Newsletter ANPI

La gestione di una rubrica qualificata e l'invio di messaggi è cosa che naturalmente può essere fatta da qualsiasi software di posta elettronica, però con lo strumento che trovate all'indirizzo http://servizi.anpi.it/messaggi/ potrete usare alcune scorciatoie e dare più libertà ai vostri contatti.

Introduzione

L'invio di messaggi informativi è un modo efficace per avvertire in un attimo centinaia di persone, ma se fatto nel modo sbagliato rischia di farne arrabbiare una buona parte.
Per questo lo strumento che l'ANPI mette a disposizione è centrato sulle buone pratiche e molto attento alla privacy di chi riceve i messaggi.

Questa applicazione gestisce gruppi di indirizzi di posta elettronica.
Può essere usata come una semplice rubrica, dove potete organizzare gli indirizzi in gruppi e poi usarli con il vostro software preferito.

Potete usarla anche per inviare direttamente messaggi ad una o più rubriche contemporaneamente, senza che i vostri utenti ricevano più messaggi se compaiono in più rubriche.
Ma anche se usate il vostro software troverete alcune utili scorciatoie.

Potrete inoltre permettere a chiunque di iscriversi ad una particolare rubrica in automatico, senza passare dal gestore. Ogni utente potrà poi liberamente cancellarsi in modo semplice e automatizzato se e quando lo vorrà.

Nota importante: questo è uno strumento essenzialmente monodirezionale, non serve per creare gruppi di discussione o forum.
Una nota anche sui termini usati in questa documentazione: con gestore di una o più rubriche si intende la persona che crea tali rubriche e che può inviare messaggi, con utenti si sottintendono gli indirizzi che compongono le rubriche, ovvero coloro che ricevono i messaggi.

Termini del servizio

Questo servizio viene offerto a tutte le Sezioni e a tutti i Comitati ANPI di ogni ordine e grado.
Per poterne usufruire è necessario contattare la Segreteria Nazionale e contestualmente avvisare il gestore del servizio all'indirizzo netmaster@anpi.it

Fare e gestire una rubrica

Creare una rubrica

  • Nome della rubrica: è, manco a dirsi, il nome della rubrica che state creando, fate in modo che sia sufficientemente descrittivo: ad esempio Iscritti ANPI è un po' poco, molto meglio Novità antifasciste della provincia di Milano.
  • Etichetta: è un testo brevissimo, non più di 40 caratteri, che comparirà nel titolo di ogni messaggio che invierete: serve ai vostri utenti per riconoscere a colpo d'occhio che uno dei vostri messaggi, è utile anche perché sulla base di queto breve testo i vostri utenti possono catalogare i vostri messaggi e separarli automaticamente dagli altri. Un esempio può essere ANPI Viareggio.
    Notate che due rubriche non possono avere la stessa etichetta. E questo è valido a livello di tutta l'applicazione.
  • Email di riferimento: è l'indirizzo che comparirà come mittente dei vostri messaggi, di base è lo stesso con cui siete stati registrati ma potete mettere qualunque altro indirizzo.
    È importante che sia un indirizzo che guardate, è a questo indirizzo che i vostri utenti potrebbero contattarvi per richieste e approfondimenti.
  • Descrizione: fate una descrizione completa del tipo di notizie che invierete usando questa rubrica, è un buono posto anche per scrivere in breve chi siete
  • Firma: è un testo che comparirà alla fine di tutti i vostri messaggi, potete lasciarlo vuoto oppure mettere i contatti principali della vostra Sezione
  • Pubblica: se spuntate questo campo la rubrica sarà pubblica, ad una rubrica pubblica ci si può iscrivere liberamente, altrimenti solo il gestore può iscrivere qualcuno.
    Maggiori dettagli nel capitoletto intitolato Come iscrivere utenti ad una rubrica.
  • Indirizzi da aggiungere: in questo spazio buttate tutti gli indirizzi di posta elettronica che desiderate inserire, il formato in cui li mettete non è così importante: possono essere separati da spazi, da virgole, da punti e virgola, possono essere messi uno per riga, possono essere mischiati a del testo che non c'entra nulla, possono anche essere ripetuti più volte. Le cose andranno come vi aspettate: l'applicazione sa riconoscere la forma di un indirizzo di posta elettronica e solo questi finiranno nella rubrica, senza doppioni.

Modificare una rubrica

Qui compaiono tutti i campi che già avete visto in fase di creazione. Vale la pena di spendere due righe solo per i seguenti:

  • Indirizzi da aggiungere: funziona esattamente come in fase di creazione, ma non vi preoccupate se qui scrivete degli indirizzi che sono già presenti, come già detto l'applicazione se ne accorgerà e non farà doppioni.
  • Indirizzi da togliere: anche qui potete inserire liste di indirizzi nel modo che più vi è comodo, l'applicazione separerà gli indirizzi di posta elettronica dal resto. Gli indirizzi di posta elettronica che inserirete qui verranno cancellati dalla corrispondente rubrica.
    Fra indirizzi da aggiungere e indirizzi da togliere è quest'ultimo campo ad avere la precedenza, se mettete un indirizzo in entrambi questo non solo non verrà inserito ma verrà cancellato nel caso fosse già stato presente nella rubrica.

Cancellare una rubrica

Facendo click sul rispettivo link vi verrà presentata la pagina in cui potete dare conferma definitiva.

Come iscrivere utenti ad una rubrica

Quando la rubrica è pubblica allora questa diventerà visibile nella lista che compare all'indirizzo http://servizi.anpi.it/messaggi/, comparirà nelle ricerche effettuate tramite la piccola maschera sotto il menu a destra e sarà possibile iscriversi senza passare dal gestore.
Se invece avete deciso che la rubrica non è pubblica allora queste cose non potranno essere fatte e solo il gestore potrà aggiungere indirizzi.

Ogni rubrica pubblica possiede un indirizzo del tipo http://servizi.anpi.it/messaggi/iscrizione_rubrica/XXX/ (dove al posto di XXX c'è un numero) al quale chiunque può dare il proprio indirizzo di posta elettronica ed iniziare a ricevere i messaggi che invierete.
L'indirizzo relativo alle vostre rubriche si trova subito sotto il titolo quando ne guardate i dettagli.
A meno che non siate ben certi di quello che fate è una buona idea invitare gli utenti a visitare tale link invece che iscriverli di peso.

Ad esempio potreste valutare che la rubrica in cui pubblicizzate le iniziative della vostra sezione sia pubblica, ma che quella con cui fate comunicazioni riservate non lo sia.

Anche se una rubrica è pubblica il gestore potrà sempre aggiungere o togliere indirizzi a proprio piacimento.

Come cancellare gli utenti da una rubrica

Qualsiasi utente potrà sempre cancellarsi da una qualsiasi rubrica a cui è iscritto, senza dover chiedere nulla al relativo gestore.
Oltre ad essere una cosa dettata dal buon senso e dalla buona educazione è pure un requisito di legge. Altrimenti i vostri messaggi saranno considerati spam (oddio, non è esattamente così e la legislazione su questi argomenti è migliorabile, ma fidatevi. O volete far arrabbiare il garante della privacy?).

Naturalmente un gestore può sempre aggiungere o togliere indirizzi a proprio piacimento, basta andare nella maschera per modificare una rubrica.

Inviare messaggi

Inviare messaggi direttamente

La maschera attraverso la quale potete inviare un messaggio è così fatta:

  • Rubriche: la lista delle rubriche che gestite, selezionate quelle a cui volete inviare il messaggio. Gli iscritti a più rubriche riceveranno comunque un solo messaggio.
  • Titolo del messaggio: non includete l'etichetta della lista, verrà messa in automatico
  • Corpo del messaggio: qui potete scrivere il contenuto del vostro messaggio, potete fare del testo ricco (cioè scrivere in grassetto, cambiare carattere e le solite cose che fate nei software simili). Potete anche decidere di mettere solo testo semplice: subito sotto questo campo c'è un link che disabiliterà il testo ricco (e lo riabiliterà se ci cliccate ancora).
    Qualora scriviate testo ricco ma gli utenti non abbiano il modo di leggerlo (nel caso usino software vecchio o particolare) non dovrebbero comunque esserci problemi, l'applicazione fa in modo che tutti ricevano anche un testo semplice che viene visualizzato se quello ricco non è adatto o se comunque è questo quello che preferiscono.
    Se iniziate a scrivere testo ricco e poi cambiate idea forse è meglio se ricominciate da zero.
  • Allegato: potete aggiungere un allegato al vostro messaggio.
    Notate che potete aggiungere un solo allegato, se desiderate inviare più di un file potete inserirli in un archivio (ad esempio un file ZIP) e poi allegare quello. In ogni caso la dimensione totale non dovrà superare il megabyte: oltre un terzo degli italiani non ha accesso ad internet veloce, con un allegato troppo pesante rischiate di creare dei grattacapi ad un sacco di gente.

In tutti i messaggi così inviati verranno incluse le seguenti cose:

  1. l'etichetta nel titolo del messaggio, subito prima del titolo stesso e fra parentesi quadre (è una vecchia consuetudine)
  2. la firma alla fine del corpo del messaggio
  3. un testo che spiega come potersi cancellare dalla vostra rubrica

Notate che se il messaggio viene inviato a più rubriche ed un vostro utente è iscritto a più di una riceverà il messagio una volta soltanto e l'etichetta e la firma corrisponderanno ad una sola delle rubriche in questione.
No, in questo caso non si può decidere quale sarà la rubrica da cui vengono prese firma ed etichetta, né è cosa facile determinare a priori quale delle possibili rubriche sarà usata per un dato utente.

Usare un altro software

Potete inviare messaggi alle vostre rubriche usando il vostro software di posta elettronica, tipo Outlook o Thunderbird, se è questo che preferite. L'applicazione vi mette comunque a disposizione alcuni suggerimenti e scorciatoie.

Importante: in questo caso non verrà gestito l'invio a più rubriche contemporaneamente.

Nella pagina con i dettagli della rubrica troverete un ottimistico link chiamato Tutto in un click!. Con un po' di fortuna farà ciò che promette, ovvero aprirà automaticamente il vostro programma di posta elettronica preferito con un messaggio preimpostato. Troverete:

  1. il campo A: compilato con l'indirizzo di riferimento per questa rubrica
  2. il campo CCN: compilato con la lista degli indirizzi dei destinatari
  3. il campo del titolo già popolato con l'etichetta, dovrete solo aggiungere il titolo di questo messaggio subito dopo la stessa
  4. l'area del corpo del messaggio già popolato con la firma e con il messaggio per cancellarsi dalle rubriche ANPI, dovete scrivere il messaggio vero e proprio prima della firma

C'è da dire che il successo di questa procedura dipende in gran parte dalle potenzialità del vostro sistema.
Le probabilità che funzioni aumentano se usate software recente e un browser che non sia Internet Explorer (ma che supporta JavaScript).

Se qualcosa va storto potrete seguire le istruzioni che trovate nella stessa pagina per fare un invio manualmente e ottenere il medesimo risultato.

Messaggi che tornano indietro

Capita che un messaggio inviato ad un particolare indirizzo torni indietro.
Questo può accadere per una miriade di motivi, non tutti aggirabili. Se ad esempio l'indirizzo è sbagliato c'è ben poco da fare, magari toglietelo dalla rubrica.

Se la cosa non vi torna fate così: inoltrate il messaggio tornato indietro a netmaster@anpi.it e descrivete il problema, cercheremo di tirarne fuori le gambe.

Funzionalità per sviluppatori

Attenzione: questa sezione è dedicata a funzionalità avanzate, con tutta probabilità non ne avete affatto bisogno.

L'applicazione espone una semplice API.
Ovvero l'iscrizione o la cancellazione di utenti può essere fatta anche attraverso un sito od un software esterno, ma avrete bisogno di uno sviluppatore o comunque di qualcuno che comprenda bene le cose scritte qui di seguito.

La chiave di una rubrica

Potete richiedere la chiave di una rubrica di cui siete il gestore, fatelo inviando un messaggio a netmaster@anpi.it specificando la rubrica, fatelo però utilizzando l'indirizzo email col quale siete registrati. Senza questa chiave non potete utilizzare le funzionalità descritte qui.

Una chiave è semplicemente una sequenza di 40 caratteri alfanumerici e serve per assicurarsi che chi fa una delle possibili operazioni sia davvero chi dice di essere.
È roba segreta! Non la dite a nessuno, chi conosce questa stringa di testo può iscrivere e cancellare utenti dalla vostra rubrica, è un po' come una password.
Nel caso l'abbiate data a qualcuno che non doveva averla contattatate immediatamente netmaster@anpi.it

Iscrivere o cancellare utenti

Detto in parole povere dovete fare una richiesta con metodo POST al seguente indirizzo:

http://servizi.anpi.it/messaggi/remote/

Notate che in caso chiamiate quest'indirizzo con metodo diverso da POST otterrete in risposta uno status 404.

Il corpo della richiesta deve contenere le seguenti coppie di chiave-valore:

  • operator: ADD oppure DEL, rispettivamente per iscrivere o cancellare
  • list: il numero identificatico della rubrica per la quale volete fare la richiesta, viene inviato al gestore quando riceve anche la chiave, ma comunque si tratta del numero di cui si parla nel capitolo Come iscrivere utenti ad una rubrica
  • address: l'indirizzo di posta elettronica che votete iscrivere o cancellare
  • signature: è una stringa alfanumerica, che va ricavata giustapponendo in sequenza i tre precedenti valori e la chiave per poi calcolare SHA1 del risultato
  • success_URL: è la URL (completa di http://) a cui redireziona in caso di successo, se non avvalorata l'applicazione restituirà una risposta con status 200 e popolata col solo carattere "1"
  • fail_URL: è la URL (completa di http://) a cui redireziona in caso di fallimento, se non avvalorata l'applicazione restituirà una risposta con status 200 e popolata col solo carattere "0"

Un esempio di calcolo della signature in PHP:


<?php
$operator  = 'ADD';
$list      = '3';
$address   = 'netmaster@anpi.it';
$key       = 'ABCD01234';
$signature = sha1($operator . $list . $address . $key);
?>

Un esempio di calcolo della signature in Python:


from hashlib import sha1

operator  = 'ADD'
list      = '3'
address   = 'netmaster@anpi.it'
key       = 'ABCD01234'
signature = sha1(operator + list + address + key).hexdigest()

Con questi parametri potete verificare che il valore corretto della signature sarà a2f6c5b2be316625d9367eca0f4d6f65d3775777

Per essere più chiari: coi precedenti parametri la richiesta all'applicazione dovrà giungere come se fosse generata da una form come la seguente.

<form action="http://servizi.anpi.it/messaggi/remote/" method="POST">
  <input type="hidden" name="operator" value="ADD" />
  <input type="hidden" name="list" value="3" />
  <input type="hidden" name="address" value="netmaster@anpi.it" />
  <input type="hidden" name="signature" value="a2f6c5b2be316625d9367eca0f4d6f65d3775777" />
  <input type="hidden" name="success_URL" value="http://esempio.it/registrazione_ok/" />
  <input type="hidden" name="fail_URL" value="http://esempio.it/registrazione_fallita/" />
  <input type="submit" />
</form>

Naturalmente se qualcosa va per il verso sbagliato potete sempre sfogarvi con il solito netmaster@anpi.it