Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Html
<div id="fb-root"></div>
<script>(function(d, s, id) {
  var js, fjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = 'https://connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.11';
  fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'facebook-jssdk'));</script>
Html
<div class="fb-like" data-href="https://confluence.wildix.com/x/2wCIAQ" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>
Html
 <div class="lang-box-pdf">
	<div>
		<div class="google-lang">
			<div id="google_translate_element">
			</div>
			<script type="text/javascript">
					function googleTranslateElementInit() {
						new google.translate.TranslateElement({pageLanguage: 'en', includedLanguages: 'de,es,fr,it,nl', autoDisplay: false}, 'google_translate_element');
						}
			</script>
			<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
		</div>
		
		<div class="pdf-button">
			<a href="https://confluence.wildix.com/spaces/flyingpdf/pdfpageexport.action?pageId=25690331" alt="Convert to .pdf" title="Convert to .pdf"><img src="https://confluence.wildix.com/download/attachments/14549012/pdf-button-download-wildix-documentation.png"></a>
		</div>
	</div>
</div>

...


Scroll export button
scopecurrent
template-id0fa09813-8b86-460a-aa1d-ef450a80e9ce
quick-starttrue
add-onScroll PDF Exporter

Info

Fax and SMS Server application allows you to send and receive faxes and SMS messages via Wildix Collaboration, to use Fax2Mail, Mail2Fax and Mail2SMS services.

Updated: October 2019July 2023

Permalink: https://confluencewildix.wildixatlassian.comnet/wiki/x/2wCIAQvAvOAQ

Table of Contents

Prerequisites

  • For Physical PBXs: Make sure that the USB drive’s partition or a Windows share for faxes is added in WMS Settings -> System -> Storages (consult WMS Start Guide, Storage services)
  • For SMS sendingexchange: W01GSM/ DaySaver gateway must be configured (Consult refer to WMS Start Guide, GSM network) 
  • Licensing requirements (more information: https://www.wildix.com/licensing/):
    • Min. UC-Essential license to activate Fax Server for all users
    • Min. UC-Essential license to exchange faxes and SMS for each user 

Number of simultaneously sent faxes depends on the number of users according to Per User licenses

To determine the number of faxes, use one of these formulas:

  • Users > 0, but < 12, faxes to be sent = 2

  • Users >= 12, but < 24, faxes to be sent = 4
  • Users >= 24, but < 40, faxes to be sent = 5
  • Users >= 40, but < 60, faxes to be sent = 6
  • Users >= 60, but < 120, faxes to be sent = 10
  • Users >= 120, but < 200, faxes to be sent = 15
  • Users >= 200, but < 300, faxes to be sent = 30
  • Users >= 300, but < 500, faxes to be sent = 40
  • Users >= 500, faxes to be sent = 45

Examples:

If you have 59 users, than then you can send 6 faxes simultaneously.

If you have 120 users, then the number of simultaneously sent faxes is 15.

General Fax/ SMS Server settings

Configuration of FAX/ SMS Server Settings can be configured is performed in WMS Settings -> System -> FAX/SMS server. Please refer Refer to WMS Settings Guide for specifying general parameters of  where you can find detailed description of FAX/SMS serverServer general parameters.


Warning

...

Important: make sure to define email address to which the copy of all the sent and received faxes and SMS will be saved. 

Mail2Fax and Mail2SMS

Mail2Fax

Note

Note: email must be sent from the email address associated to one of the users.

Set up Mail2Fax service

The PBX checks the mailbox, once new emails corresponding to the parameters of Mail2Fax service are found, the PBX sends them to one or multiple numbers present in the email.

  • Go to WMS Settings -> System -> Fax/SMS server
  • Click + to add a new Fax/SMS Server Profile
  • Enter the following parameters:
    • Name: enter the name (identifier)
    • Protocol: select the protocol of communication with your email server (POP3 or IMAP)
    • Auth type: select the preferred authorization type, Basic or OAuth2 (the support of OAuth2 for Fax/SMS Server starts from WMS 6.01.20221019.4). Depending on the chosen type, fill out the following fields:

      a) In case of Basic Auth type:
      • Server: settings of your email server to access incoming messages
    • Use SSL: enables secure connection to the server (required by some email servers)
      • User: email address of user to access to the server
      • Password: password to access to email address of user specified in the field above
      Keep e-mails and faxes on server: enables storing of messages on the server
      • Use SSL: enables secure connection to the server (required by some email servers)
      • SSL Certificate check: allows to disable SSL certificate check, e.g. in cases when the mail server uses a self-signed certificate. The parameter is enabled by default. Note: The support starts from WMS 6.03.20230630.3. 


        Image Added

      b) In case of OAuth2 authorization type: 
      • Auth provider: choose auth provider (Google or Office 365) -> click Login and perform the login 

        Image Added
    • Dialplan procedure: select the Dialplan procedure to manage faxes sent by users
    • Protection password: security password for MAIL2FAX service
    • Default LOCALSTATION:
    •  sender’s
    • sender’s fax machine ID, appears at the top of each page of outgoing fax, if not specified the default value “Fax Server” is used
    • Default LOCALHEADER:
    •  fax
    • fax header to identify the sender, appears at the top of each page of outgoing fax, if not specified the default value “Wildix PBX” is used
    • Keep e-mails and faxes on server: enables storing of messages on the server
    Click Save.
  • Click Test fetching mails  to check if the parameters are correct:


Image Added

Send Mail2Fax

Note

Note: It is possible to attach no more than 2 files to one letter. The max size of attachments to be sent is 5 MB.

...

.

...


Option 1 – Simplified

Send email in plain text or HTML format with an attachment (PDF or TIFF) to the PBX email address (specified in WMS Settings -> System -> Fax/SMS Serverserver).

  • In the email subject indicate one or more fax numbers (separated by comma)

...

  • PBX forwards the fax to one or multiple numbers indicated in the email subject

...

  • PBX follows the “fax dialplan” procedure selected in the WMS -> Users for the user who had sent the email

...

Note

Note: if Mail2Fax is sent via Remote PBX (selected in WMS Settings -> System System -> FAXFAX/ SMS server), PBX uses the Fax dialplan assigned to a user who sends Mail2Fax, instead of one specified in FAX/ SMS Server Settings.


Option 2 – OLD, using a template

  • Create an ad hoc dialplan procedure “faxout” or edit an existing Dialplan procedure, for instance “users”. Specify the prefix for line engagement
  • Send an email in plain text format with an attachment (PDF or TIFF) to the PBX email address (specified in “Fax/SMS Serverserver”) containing the text as provided in the example below
    • PRINTEDFAX: TRUE
    • FAXNUMBER: 00461019978 (destination number)
    • FROMNAME:PBX
    • STATIONID: Wildix PBX
    • HEADERINFO: Fax Server
    • FROMNUMBER:100 (fax sender)
    • LANGUAGE: it
    • ANSRETRY: 3 (number of attempts of fax sending)
    • NOANSRETRY: 5 (number of attempts of fax sending in case there is no response from the called party)
    • FAXPASSWORD: wildix (protection password)
    • CONTEXT: faxout (dialplan procedure used to manage fax calls)
    • CCNUMBER: 00461019978 00461019978 00461019978 (additional destination numbers) 

Note

Note: In this example the prefix “0” is used for the line engagement in “faxout” Dialplan procedure.


The PBX receives an email and uses the “faxout” procedure to send the fax to one or multiple numbers indicated in the email body.

Mail2SMS

Send an email in plain text format to the PBX email address containing the text as provided in the example below:

  • SENDSMS: TRUE
  • FROMNUMBER: 100 (SMS sender)
  • TONUMBER: +393412345678 (destination number)
  • SMSPASSWORD: wildix
  • CCNUMBER: +393412345678 +393412345678 (additional destination numbers)
  • MESSAGE: Hello World!

...

Fax2Mail 

Note

Make sure SMTP client is defined in WMS Settings -> System -> SMTP client (consult WMS Start Guide, SMTP Client).

The service is used for fax reception:

  • Answer an incoming call using

...

  • Fax Server and forward fax to one or multiple fax numbers / users

...

  • In case the number is used both to receive voice calls and faxes, you can add the Dialplan application “Detect fax” before this one

...

Consult Dialplan applications Guide , to check Fax to email and Detect fax chapters.

Other ways of Fax/ SMS

...

exchange

Users can send faxes and SMS to one or multiple numbers.

Send SMS via CLASSOUND 

How to send and receive SMS/ MMS via CLASSOUND

Send Fax/ SMS from Collaboration

Users can send faxes and SMS (also Post-It messages in the form of SMS) from Collaboration.

Consult /wiki/spaces/DOC/pages/30285992 FAX/ SMS section of Collaboration User Guide to get detailed information.

Send Fax from Windows / Mac OS X applications

Users can send faxes from their Windows or Mac OS X running PC using Wildix Fax Printer (merged into WIService starting from WIService v. 3.7.1).

Refer to Fax Printer for Microsoft Windows/ Mac OS X Guide.

Send SMS via remote PBX

Prerequisites: WMS 3.4x and higher.

WMS Settings -> System -> Fax/SMS Server: Remote PBX (for SMS sending): select the PBX in WMS Network Users can send SMS via Remote PBX in WMS Network.

Check FAX/SMS server chapter of WMS Settings Guide to set remote PBX.

Note

Note: it is also possible to set up a Standard SMS header.

Send SMS via HTTP request

It is possible to send SMS via CURL request using third-party service.

For more information, please refer to FAX/SMS server chapter of WMS Settings Guide.

Send SMS from Dialplan using SMS API

It is possible to send SMS from Dialplan using SMS API.

Consult the document How to send SMS from Dialplan using SMS API for details.

Inbound SMS 

Warning

Replying to an SMS is only possible with GSM gateway and is not possible in case SMS was sent via HTTP request (CURL SMS option). Note that CURL SMS sending has priority over GSM gateway , in case both modes are configured. If SMS was sent via HTTP request, there is no possibility for a recipient to reply.


Note

Make sure your GSM trunk is configured in order to provide proper functioning. Check GSM Trunk Settings.


For an SMS sent via GMS gateway only: when recipient replies to an SMS, it is possible to route the inbound SMS back to the original sender. 

How-to:

  • When replying to an SMS, prepend #extension to the message body. For example, to have the inbound SMS delivered to the user 360, write: #360 hello
  • The user receives the message as Post-It in Collaboration: 


    Image Modified

Note

Additional notes:

  • A copy of all received SMS is sent to the email address provided in GSM Trunk configuration
  • If an SMS is received with the syntax #extension <message body>, its copy is sent to the email address of the user <extension> (granted this email is provided in user's configuration)
  • If  an SMS is received with the syntax #extension <message body> and sender's number is known in  LDAP (as 'Mobility' of a user), its copy (under the form of a Post-It if the user is connected on Collaboration or as a chat message if the user is disconnected) is sent to the user <extension>


Appendix: Analog fax machine

For FXS media gateways documentation, follow Media Gateways Documentation section. 

  • Incoming Fax to FXS user. Detect fax and forward it to analog fax machine (with the possibility to send a copy to user’s email)
  • Outgoing Fax from FXS user. Send faxes from a fax machine to trunk
  • Virtual scanner. Use analog fax as a scanner (fax to email)

Note

Note: Consult Feature Codes Guide, Fax relay and Virtual scanner.

Html
<div class="fb-like" data-href="https://confluence.wildix.com/x/2wCIAQ" data-layout="button_count" data-action="recommend" data-size="large" data-show-faces="true" data-share="true"></div>


Macrosuite divider macro
dividerTypetext
dividerWidth70
emoji{"id":"smile","name":"Smiling Face with Open Mouth and Smiling Eyes","short_names":["smile"],"colons":":smile:","emoticons":["C:","c:",":D",":-D"],"unified":"1f604","skin":null,"native":"😄"}
textColor#000000
dividerWeight2
labelPositionmiddle
textAlignmentcenter
iconColor#0052CC
fontSizemedium
textNot finding the help you need? Join the Facebook group to ask a question!
emojiEnabledfalse
dividerColor#DFE1E6
dividerIconbootstrap/CloudsFill

Button macro
buttonTextFacebook
isButtonShadowOntrue
emoji{"id":"smile","name":"Smiling Face with Open Mouth and Smiling Eyes","short_names":["smile"],"colons":":smile:","emoticons":["C:","c:",":D",":-D"],"unified":"1f604","skin":null,"native":"😄"}
buttonBorderColor#4267b2ff
buttonColor#4267b2ff
buttonNewTabfalse
buttonFontColor#ffffff
buttonSizemedium
buttonIconColor#ffffff
buttonWidthDetection46
buttonHoverColor#ffffff
buttonIconfont-awesome/FacebookSquare
buttonTypeicon_left
buttonLink{"link":"https://www.facebook.com/groups/wildixtechwizards","source":"direct"}
buttonNewLink
buttonRadius3
buttonShadow0
id228
emojiEnabledfalse
buttonWidth20