Administration Guide 07 Oct 2021 TM and copyright © 2010-2021 Imagicle spa Table of Contents Administration Guide.................................................................................................................................................................1/75 Configuration Task List...........................................................................................................................................................1/75 Description and Architecture.................................................................................................................................................2/75 Users and faxboxes configuration........................................................................................................................................5/75 Administrative configuration..................................................................................................................................................7/75 Telephony signalling and routing........................................................................................................................................15/75 Advanced Configuration......................................................................................................................................................17/75 Service management..........................................................................................................................................................24/75 Email-to-Fax Microsoft OAuth2 Authentication..................................................................................................................25/75 Cover pages.........................................................................................................................................................................37/75 Solution-specific Configuration............................................................................................................................................39/75 ..............................................................................................................................................................................................43/75Troubleshooting....................................................................................................................................................................41/75 License Activation.................................................................................................................................................................46/75 PBX Configuration................................................................................................................................................................47/75 Print To Fax...........................................................................................................................................................................54/75 Product Integration API...........................................................................................................................................................57/75 Overview...............................................................................................................................................................................57/75 Submit Fax............................................................................................................................................................................58/75 Get Outbound Fax Details...................................................................................................................................................63/75 Download outbound fax document....................................................................................................................................65/75 Get Outbound Faxes List......................................................................................................................................................67/75 Get Inbound Faxes List.........................................................................................................................................................69/75 ....................................................................................................................................................................................69/75 Get Inbound Fax Details......................................................................................................................................................72/75 Download Inbound fax document......................................................................................................................................74/75 Administration Guide Configuration Task List Warning: you must install and configure the Application Suite before being able to configure the single applications. Please go through the AppSuite Deployment, Main Configuration, and User Management sections before reading on. You can easily configure Digital Fax trough the following mandatory steps: • Activate the product license (within 30 days) • Configure the PBX • Configure the fax server protocols and routing • Start the service • Configure the relevant users and fax boxes through users management • Configure the application, including the email parameters and fax routing • Configure the fax service parameters Optionally, you may want to configure: • Print to Fax • Multifunctional printer integration • Automatic Fax Backup • Incoming Fax Print • Group Faxing • Mass Faxing These tasks are described in the Advanced Configuration section of this guide. Administration Guide 1/75 Administration Guide Description and Architecture Traditional manual faxes are out of date. Digital Fax is a complete software solution including a robust fax server based on Imagicle unique Fax to IP driver, able to interoperate directry with the PBX trough Voip comminication. A professional fax server grants substantial savings and it improves customer service and company image; the process of sending a fax is faster and incoming faxes are automatically integrated with today's web and email-based workflow. Digital Fax delivers a complete IP fax server solution, allowing users to send and receive faxes directly from any email client or through a dedicated web interface. Digital Fax can be seamlessly integrated with any e-mail server using standard SMTP/IMAP-POP3 protocols without enforcing specific infrastructure requirements. Digital Fax can automatically route incoming faxes in TIFF/PDF formats to each user's mailbox and personal web interface, picking out the right recipient by the Called Line Identifier (also known as "extension") or by the line on which the fax was received. This enables users to check faxes from anywhere in the world using either: • A traditional desktop email client (i.e.: Outlook, Lotus Notes...). This is the Email to Fax feature • A web browser (Internet Explorer, Chrome, Firefox...). This is the Web To Fax feature To send a fax, each user can either: • Create it as a new message in his/her email client, the Email To Fax feature • Upload a document via web through a dedicated web page, the Web To Fax feature • Directly print from any application to the Digital Fax network printer, the Print To Fax feature After the fax is sent, the user receives a transmission report in his/her inbox. Digital Fax automatically manages the outgoing queue, trying to send the fax again if it not succeeded. Together with the other units of the Application Suite, Digital Fax completes the Unified Messaging Solution for Cisco Unified Communication. Architecture Digital Fax can be used as an Email To Fax gateway together with any SMTP/POP3 or IMAP mail server, allowing users to send and receive faxes directly by their email client. Special email system will be discussed later (MS Outlook). In order to set up this feature, you must create a dedicated mailbox on the mail server, from which Digital Fax will fetch the faxes that will be sent out. Digital Fax needs an email server to: • Download emails sent by the users to a specified account (ex. [email protected]) with the file to be faxed (this is the Outgoing faxes - POP3 behavior) • Notify each user of incoming faxes via email with the fax as attachment (this is the Incoming faxes - SMTP behavior). See the Receive a fax section for further details on how let users receive a fax This is the architecture of the Email To Fax behaviour: Administration Guide 2/75 Description and Architecture Users send emails to a specified recipient (for instance: [email protected]), specifying the fax recipient number in the subject field and attaching the file to be faxed. Multiple recipients and multiple attachments are supported. Digital Fax must be configured with the designated IMAP/POP3 account (in our example: [email protected]) and the polling interval for email checking. Digital Fax downloads the email and converts the attached file to a fax by printing it to a graphic file. This will be queued to be sent to the specified recipient number. Note: Digital Fax can send many faxes at the same time, limited only by the number of avaliable lines and license channels. Even if many channels are free, faxes addressed to the same recipient number will always start one after the other. This means that the second fax will start only when the first has been sent or it has exhausted its retries. When the fax has been processed, Digital Fax notifies the sender with a return receipt