=begin options write = root =end options =head2 Twinkle SIP softphone =head3 Twinkle Configuration (current version. Starting from 1.4.2) When you start Twinkle for the first time you'll see a configuration dialog window. Choose "Diamondcard" button and specify your Diamondcard Account ID# and PIN code. If you do not have a Diamondcard account please use L<signup|https://www.diamondcard.us/exec/voip-login?act=sgn&spo= twinkle> link in this dialog window. If you were using Twinkle before and upgraded to a new version, please use Diamondcard menu to specify your Account ID# and PIN code. =head3 Twinkle Configuration (versions before 1.4.2) 1. Create new user profile. Open menu "File"->"Change user" and press "New" button. Specify profile name, e.g. Diamondcard. User profile settings: =over =item * User B<Your name:> First name, last name. If you specify a number at the end of this field it'll be used as your Caller ID. E.g. "John Smith 13031231234" B<User name:> Enter your Diamondcard Account ID# B<Domain:> sip.diamondcard.us B<Realm:> sip.diamondcard.us B<Authentication name:> Enter your Diamondcard Account ID# B<Password:> Enter your Diamondcard PIN code. This is located in the upper right hand corner in the main page of your Diamondcard administration center. https://www.diamondcard.us/login =item * SIP server B<Expiry:> 300 seconds B<Register at startup> checked B<Use outbound proxy> checked B<Outbound proxy:> sip.diamondcard.us =item * Voice mail B<Voice mail address:> 80 =item * RTP audio We recommend one of the G.711 codecs u-law or A-law. If you have limited bandwidth or a satellite connection you may get better results using iLBC codec. Use our L<Echo test|EchoTest> to check your internet connection and prospective call quality. =back Save new profile and click check-box for new profile. It will display in profile list on the front panel of the phone. 2. Make your user profile available after startup Menu "Edit"->"System settings" click check box for new Diamondcard profile. =head3 Verifying connection To verify your internet connection and Twinkle setup you can dial our L<Echo test|EchoTest> number: 441. Check your L<Account balance|CheckBalance> by dialing 440. This test tells you if your internet connection will give you good call quality. If the test is not sounding good then your calls will not sound good. Make sure you have the Diamondcard user profile selected on the front panel of the phone when making a call. User: Diamondcard =head3 Dialing rules Dial phone numbers you wish to call in international format: country code + area code + number.<br> E.g. 18002001000 for USA +1-800-200-1000 number. No international prefix like 011 or 001 is necessary. Make sure you have the Diamondcard user profile selected on the front panel of the phone when making a call. User: Diamondcard =head3 Sending SMS Messages Click "Instant message" on the tool bar or choose it from the menu User profile: Diamondcard To: phone number in international format. E.g. 442071234567 to send an SMS message to a UK number. SMS message will be sent from the phone number specified in the caller ID section of your admin center. Login at https://www.diamondcard.us/login. Go to TELEPHONY section, then click L<options - caller id|CallerID>. Make sure you set it to your cell (mobile) phone number if you expect to receive SMS responses back to you. Number should be specified in international format as explained above. Rates and details about sending SMS's are available in your Diamondcard admin center by clicking on CALL RATES link which is the first link in the TELEPHONY section. =head3 Receiving calls To receive calls from regular phones with Twinkle you need to buy a L<personal number/DID|PersNumbers> and configure its forwarding. To purchase a DID, login to your admin center and click "online shopping" link. You can buy local and toll free numbers from many countries. In your admin center the "personal #'s" page allows you to configure your purchased DID's. To receive calls with Twinkle, DID should be forwarded to "Your IP phone" choice in the forwarding profile. Using "Default" redirect profile will also do it. Twinkle phone should be configured to use Diamondcard. =head3 Caller ID With Diamondcard you can specify a phone number for your caller ID. You enter this data in the "Your name" field. Choose: Edit -> User Profile ->User and fill "Your name" field with your phone number. E.g.: "Your name": John Smith 130312345678 130312345678 - will be used as a CallerId. You can find more details about configuring L<Caller ID here|CallerID> =head3 Linux distros notes L<Ubuntu|TwinkleUbuntu> X<SIP Twinkle SMS>