Set Up a Yeastar FXS Gateway in Bulk¶
This guide creates one user per analog line, each with an extension and a SIP device, and attaches all of them to the FXS ports of one Yeastar TA gateway. It uses two CSV uploads, so 32 lines take a few minutes instead of 32 manual setups.
The example is a Yeastar TA3200 (32 FXS ports) on a new account where nothing is configured yet. For a smaller gateway, use fewer rows and the matching model (see Yeastar (TA FXS gateway)).
How it works¶
flowchart LR
U["User CSV<br/>Extension 201<br/>Phone Name: Yeastar Port 01<br/>SIP Phone: 1"] -->|creates| D["User + SIP device<br/>Yeastar Port 01"]
P["Phone CSV<br/>Button 1: Line<br/>Button_Ext 201<br/>Button_Line_Device: Yeastar Port 01"] -->|links| K["Gateway phone<br/>line key 1"]
D --> K
K -->|provisioning| G["Yeastar TA3200<br/>FXS port 1"]
- The user CSV creates each user and their SIP device, giving the device a fixed name.
- The phone CSV creates the gateway phone and sets one Line button per port. Each button names the user's extension and that same device name, which links the existing device.
- Line button N becomes FXS port N on the gateway.
Why two files
The user file can provision a phone, but it adds a line key only when it creates a phone. Several users on the same MAC would leave only the first one on the gateway. The phone file sets every port.
What you need¶
| Item | Details |
|---|---|
| Portal access | An account admin of the account, or a reseller or super admin with that account selected. |
| The gateway MAC | Printed on the gateway label, for example AABBCCDDEEFF. |
| A list of lines | One name and one extension per FXS port. Extensions are numbers, 3 to 6 digits by default. |
Select the right account first
As a reseller or super admin, switch into the customer's account with the account selector before every step. Profiles, users and phones are created in the account that is selected. If you stay on your own account, the users are created there.
Step 1: Create the Yeastar profile¶
- Go to Provisioning → Profiles and add a profile.
- Set Profile Name to
Yeastar TA3200. The phone file refers to the profile by this name. - Set Manufacturer to
Yeastarand Model toTA3200. The model sets how many FXS ports the gateway configuration has. - Keep the other settings unless you need to change them, and click Save Profile.
The phone import looks profiles up by name and never creates one, so this step must come first.
Step 2: Create the users¶
Build the user file in the format described in Bulk User Import. For each port, fill:
| Column | Example | Why |
|---|---|---|
First Name, Last Name, Email |
Port, 01, port01@example.com |
Required. Each email must be unique. Use a room or line name if the line has no person. |
Extension |
201 … 232 |
Must match Button_Ext in the phone file. |
Phone Name |
Yeastar Port 01 … 32 |
The SIP device name. Must match Button_Line_Device in the phone file. |
SIP Phone |
1 |
Creates the SIP device. |
Directory |
1 |
Lists the line in the company directory. |
Admin, UCP, UCP Mobile, Conferencing, Send Invitation |
0 |
An analog line needs none of these. |
Leave Phone Profile, MAC Address, Phone Manufacturer and Phone Model empty. The phone file does the provisioning.
First Name,Last Name,Email,Extension,SIP Username,Phone Name,Phone Profile,Phone Label,Phone Number E164,Directory,Admin,UCP,UCP Mobile,SIP Phone,MAC Address,Phone Manufacturer,Phone Model,SIPURI,Cell Phone,Caller ID Name,Caller ID Number,Conferencing,Conferencing PIN,Send Invitation,Invitation Status,Numbers,Cellphones,Tags,Feature Plan
Port,01,port01@example.com,201,,Yeastar Port 01,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,02,port02@example.com,202,,Yeastar Port 02,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,03,port03@example.com,203,,Yeastar Port 03,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,04,port04@example.com,204,,Yeastar Port 04,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,05,port05@example.com,205,,Yeastar Port 05,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,06,port06@example.com,206,,Yeastar Port 06,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,07,port07@example.com,207,,Yeastar Port 07,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,08,port08@example.com,208,,Yeastar Port 08,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,09,port09@example.com,209,,Yeastar Port 09,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,10,port10@example.com,210,,Yeastar Port 10,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,11,port11@example.com,211,,Yeastar Port 11,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,12,port12@example.com,212,,Yeastar Port 12,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,13,port13@example.com,213,,Yeastar Port 13,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,14,port14@example.com,214,,Yeastar Port 14,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,15,port15@example.com,215,,Yeastar Port 15,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,16,port16@example.com,216,,Yeastar Port 16,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,17,port17@example.com,217,,Yeastar Port 17,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,18,port18@example.com,218,,Yeastar Port 18,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,19,port19@example.com,219,,Yeastar Port 19,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,20,port20@example.com,220,,Yeastar Port 20,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,21,port21@example.com,221,,Yeastar Port 21,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,22,port22@example.com,222,,Yeastar Port 22,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,23,port23@example.com,223,,Yeastar Port 23,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,24,port24@example.com,224,,Yeastar Port 24,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,25,port25@example.com,225,,Yeastar Port 25,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,26,port26@example.com,226,,Yeastar Port 26,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,27,port27@example.com,227,,Yeastar Port 27,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,28,port28@example.com,228,,Yeastar Port 28,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,29,port29@example.com,229,,Yeastar Port 29,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,30,port30@example.com,230,,Yeastar Port 30,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,31,port31@example.com,231,,Yeastar Port 31,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Port,32,port32@example.com,232,,Yeastar Port 32,,,,1,0,0,0,1,,,,,,,,0,,0,,,,,
Upload it from Users → Upload → Upload CSV File → Send CSV File and Create Users. Check that all 32 users appear before you continue. A Line button for an extension that does not exist fails with user not found for extension.
Step 3: Attach the devices to the gateway¶
Build the phone file in the format described in Import phones from CSV: one template row with the profile name, then one Line button per port.
| Column | Template row | Button rows |
|---|---|---|
MAC |
the gateway MAC | the same MAC |
Template |
Yeastar TA3200 |
empty |
Button_Location |
empty | keys |
Button_Number |
empty | 1 … 32, the FXS port |
Button_Type |
empty | Line |
Button_Ext |
empty | the user's extension |
Button_Line_Device |
empty | the user's SIP device name from step 2 |
Replace AABBCCDDEEFF with the gateway MAC on every row.
MAC,Template,Note,Account_Label,Button_Location,Button_Number,Button_Type,Button_Label,Button_Ext,Button_Line_Device,Button_Page_IP,Button_Value,Reboot
AABBCCDDEEFF,Yeastar TA3200,Yeastar TA3200 FXS gateway,Yeastar,,,,,,,,,
AABBCCDDEEFF,,,,keys,1,Line,Port 01,201,Yeastar Port 01,,,
AABBCCDDEEFF,,,,keys,2,Line,Port 02,202,Yeastar Port 02,,,
AABBCCDDEEFF,,,,keys,3,Line,Port 03,203,Yeastar Port 03,,,
AABBCCDDEEFF,,,,keys,4,Line,Port 04,204,Yeastar Port 04,,,
AABBCCDDEEFF,,,,keys,5,Line,Port 05,205,Yeastar Port 05,,,
AABBCCDDEEFF,,,,keys,6,Line,Port 06,206,Yeastar Port 06,,,
AABBCCDDEEFF,,,,keys,7,Line,Port 07,207,Yeastar Port 07,,,
AABBCCDDEEFF,,,,keys,8,Line,Port 08,208,Yeastar Port 08,,,
AABBCCDDEEFF,,,,keys,9,Line,Port 09,209,Yeastar Port 09,,,
AABBCCDDEEFF,,,,keys,10,Line,Port 10,210,Yeastar Port 10,,,
AABBCCDDEEFF,,,,keys,11,Line,Port 11,211,Yeastar Port 11,,,
AABBCCDDEEFF,,,,keys,12,Line,Port 12,212,Yeastar Port 12,,,
AABBCCDDEEFF,,,,keys,13,Line,Port 13,213,Yeastar Port 13,,,
AABBCCDDEEFF,,,,keys,14,Line,Port 14,214,Yeastar Port 14,,,
AABBCCDDEEFF,,,,keys,15,Line,Port 15,215,Yeastar Port 15,,,
AABBCCDDEEFF,,,,keys,16,Line,Port 16,216,Yeastar Port 16,,,
AABBCCDDEEFF,,,,keys,17,Line,Port 17,217,Yeastar Port 17,,,
AABBCCDDEEFF,,,,keys,18,Line,Port 18,218,Yeastar Port 18,,,
AABBCCDDEEFF,,,,keys,19,Line,Port 19,219,Yeastar Port 19,,,
AABBCCDDEEFF,,,,keys,20,Line,Port 20,220,Yeastar Port 20,,,
AABBCCDDEEFF,,,,keys,21,Line,Port 21,221,Yeastar Port 21,,,
AABBCCDDEEFF,,,,keys,22,Line,Port 22,222,Yeastar Port 22,,,
AABBCCDDEEFF,,,,keys,23,Line,Port 23,223,Yeastar Port 23,,,
AABBCCDDEEFF,,,,keys,24,Line,Port 24,224,Yeastar Port 24,,,
AABBCCDDEEFF,,,,keys,25,Line,Port 25,225,Yeastar Port 25,,,
AABBCCDDEEFF,,,,keys,26,Line,Port 26,226,Yeastar Port 26,,,
AABBCCDDEEFF,,,,keys,27,Line,Port 27,227,Yeastar Port 27,,,
AABBCCDDEEFF,,,,keys,28,Line,Port 28,228,Yeastar Port 28,,,
AABBCCDDEEFF,,,,keys,29,Line,Port 29,229,Yeastar Port 29,,,
AABBCCDDEEFF,,,,keys,30,Line,Port 30,230,Yeastar Port 30,,,
AABBCCDDEEFF,,,,keys,31,Line,Port 31,231,Yeastar Port 31,,,
AABBCCDDEEFF,,,,keys,32,Line,Port 32,232,Yeastar Port 32,,,
Upload it from Provisioning → Phones → Import. The result should report one MAC and 0 line devices created.
Device names must match
If a Button_Line_Device does not match the device name from step 2, the import creates a second SIP device for that user instead of failing, and the result reports it as a created line device. Keep Phone Name and Button_Line_Device identical.
Step 4: Provision the gateway¶
- Open the new phone in Provisioning → Phones, check the configuration with Preview config, and unlock it.
- On the gateway, set Auto Provision Settings to the provisioning Server URL as described in Yeastar (TA FXS gateway).
- Save and apply. The gateway downloads its configuration at the next scheduled run. A reboot alone does not trigger it.
Each FXS port then registers as its user's SIP device: port 1 as extension 201, through port 32 as extension 232.
Check that it works¶
- The account has 32 users, each with one SIP device named
Yeastar Port NN. - The gateway phone uses profile
Yeastar TA3200and has 32 Line buttons in port order. - The configuration preview shows a SIP username on each FXS port.
- A call to extension 201 rings the analog phone on port 1, and the same holds for 232 on port 32.
Related topics¶
- Bulk User Import: every user file column
- Phone Provisioning: profiles, phone import and Yeastar gateway settings