====== Telephone Ports ======

<if !fxs>
^ :!: Your Internet Gate does not have Phone Ports. ^
| Some models might have the hardware present, but require a [[:license]] to be able to activate and use it. |
</if>

<if !fxo>
^ :!: Your Internet Gate does not have a Telephone Line Port. ^
| Some models might have the hardware present, but require a [[:license]] to be able to activate and use it. |
</if>

Internet Gate's telephone ports allow you to:
  * connect analogue telephones to it, converting them to IP-phones [[wp>Foreign exchange station|FXS]]
  * connect it to the global telephone network, and be able to make and receive ordinary telephone calls [[wp>Foreign exchange office|FXO]]

Phone ports are marked **PH1**, **PH2** on the [[:product overview:back panel]] of the Internet Gate, and **LINE** for connection to the global telephone network.
{{ :web_gui:telephone_ports_page.png?312|Telephone Ports page in rel 5.30}}

===== Phone Ports (FXS) =====
Connect a telephone to the FXS port to make ordinary or SIP calls. It is possible to connect up to 5 phones to each FXS port. The two phone ports allows you to have two different registrations (phone numbers).

FXS1 controls port PH1, FXS2 controls port PH2.

For each port you specify the **SIP address** to use, and (if authentication is required) the **user ID** and **password**. The SIP address is a combination of your username and your domain, like %%john@company.com%%. Used ID might be the same as your username, if not specified separately. **Display name** is the descriptive username sent to other SIP phones when you make calls (usually your own name).

==== Call Control ====
You can make calls and control your phone either by dialing on the phone or clicking on the buttons on this webpage.

:!: The dialcodes you dial on your phone for certain actions are country dependent. For each button on the web interface you see the according dial code to perform the same action dialing on the phone.

Using the buttons or dial codes you can **dial** (make calls), **transfer** calls to other recipients, **reject** (deny) an incoming call, and have two calls you can alter between or join together for a mini-conference:
  * **Other Call** - put current call on hold, switch to other call
  * **Hang up** - end the current call, switch to other call
  * **Conference** - join both calls into a mini-conference where all three parties can hear each other
  * Attended **Transfer** - transfer the call currently on hold to the active call's recepient

==== Configuration ====
You can enable **call waiting** (small beeps indicate another incoming call while you are in a call, and you can put current call on hold and answer that new call), **do not disturb** and **anonymous call**s.

You can also select **telephony keys style** - what dialcodes to press on phone for different functions. Select style and press Apply to see according dialcodes in Call Control buttons.

===== Telephone Line Port (FXO) =====
By connecting Internet Gate to a landline it can act as a gateway between the global telephone network and IP telephony. You can use **//any SIP phone registered to it//** to call ordinary telephone numbers or answer incoming calls! (Not just the PH1/PH2 phones.)

==== Make calls ====
To make calls to ordinary telephone numbers you can enter the telephone number to call, with either a special **domain** or **prefix**:
  * **domain** is by default "localgw" meaning entering "%%5551234@localgw%%" as a SIP address to call will call ordinary telephone number 555 1234. You can change that virtual domain name to anything else desired.
  * **prefix** is by default "%%**%%" meaning entering "%%**5551234%%" or "%%**5551234@yourdomain.com%%" will call ordinary telephone number 555 1234. You can change that prefix to anything else desired. ((The Dial Plan feature of the [[SIP switch]] overrides this setting.))

:!: For security reasons you are **strongly recommended** to limit who are allowed to make calls on the global telephone network. Recommended settings are **Inside users: Authenticate**, **Outside users: None** unless you want to allow e.g. remote workers use your landline.

^ :!: SECURITY WARNING! ^
| Allowing outside users use your Internet Gate's Telephone Line Port allows **anyone on the Internet** (who have guessed //any// of your user's passwords) to make expensive calls to pay-numbers! |

==== Answer incoming calls ====
You can forward calls coming from the global telephone network to your landline's telephone number to **any SIP phone** you desire.

You can either forward incoming calls to a specific phone, or let the caller select what extension she wants to reach.

=== Specific phone ===
Enter **Forward incoming calls to** the number or full SIP address you want to receive the calls.

If you want a backup phone then select **during** nr of **ring signals**, **Collect: No**, and **Forward to** number or full SIP address of secondary phone to receive call if first phone didn't answer it.

=== Select extension ===
Internet Gate can answer incoming calls, present a new dialtone and allow caller to dial the extension she wants to reach.

Leave **Forward incoming calls to** empty, and select **during: No**. Select for example **Collect: 2 extension digits**. If you are not using Internet Gate's built-in SIP server then specify server's address.\\
Now if all your SIP addresses are numerical, numbers 00 to 99, then callers can select what SIP number address to reach on your SIP server. (By using multiple registrations a SIP phone can be registered as e.g. both %%john@company.com%%, %%555123422@company.com%% and %%22@company.com%%.) You can also use the **extension numbers** feature of the [[SIP switch]].

=== Combined ===
You can combine the two methods, allowing caller to select extension, but forwarding to a specific phone (e.g. a secretary) if e.g. no extension selected. Or prior to extension selection, or both. The incoming call answering is extremely flexible.

===== Advanced =====
There are also many [[Advanced Settings for Telephone Ports]] to fine-tune telephone port behaviours.