SCOPO DEL DOCUMENTO
Il presente documento è destinato a software houses e sviluppatori che intendono interfacciare i propri applicativi al sistema di invio fax MasterFax.
Il presente documento non tratta aspetti commerciali ed eventuali accordi che possono coinvolgere l'interfacciamento di un altro software al sistema MasterFax.

PROTOCOLLO faxsmtp
Il sistema MasterFax permette l'interfacciamento Client/Server con altri applicativi attraverso un protocollo appositamente creato basato su SMTP.
È quindi possibile integrare le funzionalità di MasterFax all'interno di un applicativo.
Il protocollo è pensato appositamente per poter operare dall'interno di una rete aziendale con accesso all'Internet tramite NAT/Masquerading. Utilizza infatti un solo canale di colloquio e la comunicazione è originata dal client.
Porta: TCP/2525
Server: faxsmtp.masterfax.net
Autenticazione: SMTP/AUTH PLAIN
Il colloquio client/server e` praticamente il medesimo di SMTP, con previa autenticazione (weak) del client.

ESEMPIO DI COLLOQUIO CLIENT-SERVER

Comunicazione	Note
[connessione]
220 masterfax.net faxsmtp 1.3 by hyppoCom at date	Welcome, server pronto Se l'invio non è disponibile: 421-masterfax.net faxsmtp 1.3... 421-Motivo di down 421 Server down
EHLO MTFaxClient V1.0	MTFaxClient = Identificativo sw client V1.0 = Versione del sw client In accordo con MasterFax, è possibile il controllo automatico della versione del software client, con una risposta speciale in caso di versione NON aggiornata: vedi prossimo scambio
250-MTFaxClient V1.0 250 AUTH PLAIN LOGIN	Welcome e tipo di autenticazione accettata In caso di Sw non aggiornato: 250-@URL http://update.it/... 250-MTFaxClient V1.0 250 AUTH PLAIN LOGIN
AUTH LOGIN	Richiesta al server di autenticarsi
334 VXNlcm5hbWU6	Richiesta al client di Username (base64)
VXNlcm5hbWU6	Invio Username base64 encoded
334 UGFzc3dvcmQ6	Richiesta al client di Password (base64)
VXNlcm5hbWU6	Invio Password base64 encoded
235 Autenticazione OK [483 credits]	Altrimenti: 535 Errore di autenticazione
MAIL FROM: <user@domain.com>	Indirizzo email a cui mandare la ricevuta
250 <user@domain.com> From
RCPT TO: <051266608>	Numero fax oppure @nomelista
250 <051266608> OK	Oppure: 501 Motivazione dell'errore
RCPT TO: <0532555555>	Altri destinatari opzionali
250 <0532555555> OK
DATA	Richiesta di inizio invio FaxBody
354 Inviare FaxBody <.> to end
Content-Type: multipart/alternative; boundary="----=MTFax_bndry" Subject: Nome del documento X-MTFax-Sched: now (oppure dd/mm/yyyy HH:MM:00)   ------=MTFax_bndry Content-Type: application/octet-stream; name=fax.ps Content-Transfer-Encoding: base64   Corpo del fax (compresso) in formato PS in base64 encoding ------=MTFax_bndry-- .	Subject: = Nome del documento, viene salvato sul db X-GFax-Sched: = Schedulazione: se non immediata (now), data di schedulazione nel formato dd/mm/yyyy HH:MM:00 È fortemente consigliato comprimere il documento con zlib, il server riconosce automaticamente tale compressione.
250 250 GF-031114155343-2245-1 OK 43487 bytes 2 destinatari	Conferma ricezione FaxBody e identificazione nome job, oppure: 550 Descrizione errore
QUIT
221 masterfax.net Closing connection