Creazione di API di testo

Quando si utilizza TextAPI, creare un file di testo (formato .txt) strutturato come segue:

Riga Descrizione
Prima riga

Specificare il numero di fax del destinatario preceduto dal doppio simbolo dei due punti nel formato seguente:

::numero fax

Ad esempio:

::12345678

Nel formato seguente è inoltre possibile includere altri parametri:

::nome, azienda, cognome, ufficio, indirizzo e-mail, numero fax

Ad esempio, per inviare un fax ad Andrea Rossi che lavora nell'ufficio vendite di Azienda Giovanni, il cui indirizzo di posta elettronica e numero di fax sono rispettivamente vendite@aziendagiovanni.com e 12345678, si dovrà inserire:

::John, John Company, Smith, Sales, sales@johncompany.com, 12345678

Seconda riga (facoltativa)

Specificare le altre opzioni di invio precedute dal doppio simbolo dei due punti. Ad esempio:

::S=listino prezzi

Separare più parametri con virgole. Ad esempio:

::c=cover1,23:15,B=5

Per ulteriori informazioni, fare riferimento a Opzioni di invio API di testo.

Altre righe Immettere il testo del messaggio da inviare per fax.

Opzioni di invio API di testo

Nella seconda riga dell’API di testo è possibile specificare una serie di opzioni di invio.

NOTA

È possibile specificare più opzioni. Separare più parametri con virgole. Ad esempio:

::s=oggetto,from=Peter,c=frontespizio1,23:15,B=5

NOTA

Per GFI FaxMaker non si applica la distinzione tra maiuscole e minuscole. I parametri possono essere specificati sia con le lettere maiuscole che con le lettere minuscole.

Opzione di invio Parametro Descrizione
Oggetto

::S=Questo è l’oggetto

o

::subject=Questo è l’oggetto

Specificare l'oggetto del fax. Questo testo viene inserito nel campo <subject> del frontespizio. Sostituire Questo è l’oggetto con il testo dell’oggetto.
Mittente

::fr=nome

o

::from=nome

Utilizzare il parametro per specificare il nome del mittente del fax. Il nome specificato è incluso come nome mittente nel frontespizio. Sostituire nome con il nome del mittente.

NOTA: Quando l’opzione non è specificata, GFI FaxMaker non dispone di informazioni sul mittente e non è pertanto in grado di restituire un report di trasmissione via e-mail. Invece, viene generato un file di risposta. Per ulteriori informazioni, fare riferimento a File di risposta TextAPI.

Allegato

::A=Nome file

Specificare un file da allegare al fax. Il file deve essere archiviato nella stessa cartella di prelievo di TextAPI.

Sostituire nome file con il nome e l’estensione del file da allegare.

Ad esempio, ::A=FaxAttachment.tif

È possibile allegare più file specificando il comando più volte. Ad esempio:

::A=file1.tif,A=file2.tif

NOTA: Gli allegati vengono rimossi definitivamente dalla cartella di prelievo. Se è necessaria una copia, assicurarsi che venga eseguita prima di spostare l’allegato nella cartella TextAPI.

Priorità

Priorità alta

::p=high

o

::p=h

o

::priority=high

o

::priority=h

Priorità bassa

::p=low

o

::p=l

o

::priority=low

o

::priority=l

Specificare la priorità del fax (alta o bassa) da utilizzare per inviare il fax.
Codice di addebito

::B=nnnn

o

::billingcode=nnnn

Utilizzare questo parametro per specificare un codice di addebito, se GFI FaxMaker è configurato per richiederne uno. Sostituire nnnn con il codice di addebito.
Pianifica

::YYYY-MM-DD-hh:mm:ss

o

::hh:mm

Indicare data e ora oppure solo l’ora per l’invio di un fax.

Sostituire:

  • AAAA - anno
  • MM - mese
  • DD - giorno
  • hh - ora nel formato 24 ore
  • mm - minuti
  • ss - secondi

Ad esempio, ::2018-04-21-16:05:00

FrontespizioPagina contenente informazioni che viene allegata e inviata come prima pagina del fax. La pagina può essere personalizzata e contenere il logo e i colori dell’azienda, le informazioni su mittente e destinatario, i dettagli del fax e altro ancora.

::C=NomeFrontespizio

o

::Coverpage=NomeFrontespizio

Per impostazione predefinita, GFI FaxMaker utilizza il frontespizio predefinito configurato in GFI FaxMaker. Utilizzare questo parametro per inviare fax con un determinato frontespizio. Sostituire NomeFrontespizio con il nome del frontespizio da usare, come configurato in GFI FaxMaker.

È inoltre possibile utilizzare ::C=none per non aggiungere un frontespizio.

Nota di copertina anteriore

::F=NotaCopertina

o

::frontcover=NotaCopertina

Utilizzare questo parametro per inviare fax con una determinata nota di copertina anteriore. Sostituire NotadicopertinaAnteriore con il nome della nota di copertina anteriore da usare, come configurato in GFI FaxMaker.

Linea faxUna linea telefonica fisica o basata su software (FoIP), collegata a una periferica fax, ad esempio un modem o una scheda ISDN/fax.

::line=n

o

::l=n

Specificare questo parametro per richiedere che il fax venga inviato tramite una determinata linea fax. Sostituire n con il numero della linea fax come configurato in Configurazione di GFI FaxMaker.

NOTA: Se la linea è occupata o non è disponibile, il fax viene inviato usando un'altra linea. Per inviare il fax unicamente da una linea particolare, utilizzare il parametro seguente:

::dl=n

Il fax non viene inviato fino a quando la linea fax specificata non è disponibile.

NOTA: il parametro dl è disponibile anche durante l'utilizzo dei comandi TextAPI negli SMS per la richiesta di invio di un SMS tramite una specifica linea GSMGlobal System for Mobile Communications.

massima

Alta risoluzione

::H

o

::high

Risoluzione normale

::N

o

::normal

Utilizzare il parametro per specificare la risoluzione del fax. Utilizzare una risoluzione elevata (200 * 200 dpi) o normale (200 * 100 dpi).
Intestazione

::fh=intestazione

o

::faxheader=intestazione

Questa opzione consente di impostare un'intestazione personalizzata aggiunta a quella predefinita all'inizio del fax. Sostituire intestazione con il testo dell’intestazione da aggiungere.
Riepilogo report di trasmissione

Invia riepilogo report di trasmissione

::tr=summary

Non mandare mai riepilogo

::tr=none

Usare summary per ricevere solo un report di trasmissione all’invio di un fax a destinatari multipli.

Usare none per non inviare un report di trasmissione dopo la trasmissione fax.

Esempio di TextAPI

::John, società di John, Smith, Sales, sales@johnscompany.com, 12345678

::from=Bob Jones,subject=Hi John,H,fh=Fax di prova

Questo è il messaggio del fax.

Cordiali saluti,

Paul