User:Joseph.voip.ms/Sandbox

From VoIP.ms Wiki

Revision as of 13:51, 7 June 2017 (view source) Joseph.voip.ms (Talk | contribs) ← Older edit		Revision as of 20:57, 7 June 2017 (view source) Joseph.voip.ms (Talk | contribs) Newer edit →
Line 1:		Line 1:
-	The '''Manage DID''' section is where you can see listed your DID numbers, check and edit their routes (where the call will be routed) and other options as well like enable/disable [[SMS | SMS]], [[Voicemail#Assigning_your_Voicemail_to_your_DID | assign  Voicemail]]'s to them, set their fail over options, etc.	+	[[File:Smslogo4.jpg|200px|left]]
-	Once you have DID numbers in your account, you will have to edit their default settings in order to receive/forward/route the incoming calls the way you need to. To do this you need to access the "'''Manage DID(s)'''" option from the "'''DID Numbers'''" menu tab.
-	[[File:MenuOption.jpg|thumb|none|600px]]
-	__TOC__
-	== DID's information ==	+	Short Message Service (SMS). This feature will allow you to send and receive messages with your DID Number (US and Canada DID Numbers Only). Currently it is in beta and will remain free until further notice.
-	At this part you can see the general information for the DID numbers (once you have [[Order a DID Number | ordered]] or [[Porting a Number | ported ]]  a DID number in)	+	Please note that this feature is for regular customer usage. '''No automation, telemarketing, bulk sending or receiving will be allowed.'''
-	Here you will see different keywords and icons that you may not be familiar with, however you can get a quick description of each one of them by clicking on the "'''Help'''" icon at the top right of the page. There is also the option to ''Export Account DIDs'', this will create a .txt file of your DID numbers and their rate centers.
-	[[File:ManageDIDs.png|thumb|none|600px]]	+	__TOC__
-	== Edit a single DID number ==	+	== Important information to know about the SMS Service ==
-	If you need to access the options to edit a single DID, the easiest way is to click on the little "'''Paper and pencil'''" icon.	+	* '''The SMS Service is in BETA version, that means it is not fully deployed. It is important to us that you report any issues with this service by sending an email to [email protected] so that the developers can get involved if necessary.'''
		+	* '''The SMS Service will be free until further notice.'''
-	[[File:EditDID.png|thumb|none|600px]]	+	* '''The SMS Service is only available for US and Canadian local DID Numbers marked with the distinctive SMS Icon.'''
		+	* '''The SMS Service can only be used to send SMS Messages to Canadian and US 10 digit numbers at this time. We also cannot guarantee that International SMS will be properly received.'''
-	The first and Main section you will see, is the "'''DID Routing'''" section, which may or may not have all the options available, this simply depends on which features you have already enabled from your portal, that is, if you have not created a [[Voicemail]], you wont be able to select this option and apply it to a DID.	+	* '''VoIP.ms reserves the right, at its sole discretion, to limit or disable the SMS service from any account that may present marketing patterns / automation patterns / bulk sending or receiving while the service is free and in beta.'''
-	This is basically the route the call will take, when someone calls to the DID. Whatever you select here, is the route the call will follow and will apply for all the calls.	+	* '''At this time we cannot guarantee that Short Code SMS Messages, which are usually 6 digits or less (e.g.: Skype, Bank Codes, TV Commercials etc...), will work.'''
-	In order to select an option, you need to click on the radio button, and then select the desired choice from the drop-down list (in case you have more than one option for that routing).	+	* '''We cannot guarantee that accents or special characters including non Latin letters will be properly delivered.'''
		+	* '''For Ported In Numbers: The SMS Functionality will be available up to 48 hours after the porting process is marked as Completed.'''
-	[[File:Routing.png|thumb|none|600px]]	+	* '''IMPORTANT: At this time, it is not possible to use a softphone to send or receive messages with our SMS Feature. This has to be done through the SMS Message Center in the Customer Portal at DID Numbers >> SMS Message Center in the Customer Portal or through https://sms.voip.ms
-	== DID's Point of Presence (POP) ==
		+	If you have further questions don't hesitate to contact the Support Staff on the Live Chat or Ticket System.
-	*You can also click the '''Show Failover Options''' button, which will display 3 more DID routing sections, just like the Main, except these are meant to be used for each one of the 3 call states, Unreachable, Busy and No answer.	+	== Identifying a SMS DID Number ==
-	This allows you to set a customized routing when the call reaches 1 of the 3 Call states, instead of just going to the [[Voicemail]].	+
-	*After, we have the '''[[Voicemail]]''' setting, here is where you need to assign a Mailbox to your DID.	+	The first thing you need to know is that this feature is only available for '''local US and Canadian numbers''' at the moment. You will note that some numbers will have a little icon of a phone device, this indicates that the number supports SMS. Please note that not all locations support SMS at this time.
-	*'''DID point of presence''', this setting is the server where you will locate your DID, in order to route the calls, this setting must match the same [[Choosing Server|server or proxy]] you are using on your [[Welcome#Devices|ATA device]], [[Welcome#PBX|PBX]] trunk or [[Welcome#Softphones|softphone]] registration in order to receive calls.	+	You can start ordering a DID Number from your portal >> DID Numbers >> Order DID >> Local Numbers >> (US or Canada) Numbers and you will be able to purchase your desired number, just make sure it supports the SMS feature.
-	[[File:PointOfPresence.png|thumb|none|600px]]	+	[[File:SMS 1.png]]
-	== Additional settings ==	+	== Configuring the SMS service ==
-	*'''Ring Time in seconds''', is basically the time the call will ring before it reaches one of the Failover states or [[Voicemail]].	+	Once purchased the SMS Service needs to be activated on the DID settings, from your portal >> DID Numbers >> Manage DID >> Edit Selection >> SMS.
-	*'''Caller ID name lookup''', when you enable this option, the system will perform a Query on the Databases, looking for a name matching the number of your caller, and will display the name on the [[Caller ID]] name section of the [[Caller ID]].	+	On that section you can activate and configure some forward options for the SMS service.
-	*'''Caller ID name prefix''', this setting will simply add any word you set, as a prefix to the [[Caller ID]] name you receive. Will also work even if you don't have "Caller ID name lookup" enabled or if you don't receive a [[Caller ID]] name. This option is specially useful when you need to differentiate incoming calls from different DIDs going to the same phone.	+	[[File:SMS_options.png]]
-	*'''Note''', this is just an Internal description for the DID, so you can manage them.
		+	The first action to take is to mark the '''Short Message Service (SMS) service''', by enabling this field the SMS Service will be active and free until further notice.
-	'''Remember that none of these changes will be saved until you press the "Click here to apply changes settings" button.'''	+	* '''VoIP.ms SMS Portal''': This is enabled by default and it can't be modified, that means that you will be able to create and send messages from the SMS Message Center.
		+	*'''SMS Email Address''': By activating this option all the SMS Messages will be sent to the email address you configure in this field. The advantage of this option is that you will receive your SMS Messages directly to your email and you will be able to Reply to these messages from your email too. You just need to click on '''reply''' to the email. Please note that e-mail responses are as well limited to 160 characters and if they exceed this limit, they'll be split in two (or more messages if applies) when sent.
		+	To reply the SMS Message via your email it is important to click on Reply and '''DON'T change or modify''' the destination mail "TO"
		+	([email protected])and the subject E.G [#USXXX] Message sent to 5555555555.
-	== Editing Multiple DIDs at a time ==	+	*'''SMS Forward''': You can have your SMS Messages forwarded to your cellphone or any other number that supports SMS, with this option you will receive the SMS Messages from our system to the configured phone number.
		+	The CallerID sent to the Call Forwarded Cell Phone will be your DID Number that received the SMS Message.
-	There are 2 additional buttons you will see when you access the Manage DID option from the menu, those are ''"Edit Selection - All settings at Once"'' and ''"Edit Selection - One Setting at a Time"''	+	*'''SMS URL Callback''': By enabling this option you will be able to send the messages to another destination e.g. your own server. If selected SMS Messages received by your DID will Send a GET request to the URL Callback provided. Available variables for your URL:
-	'''"Edit Selection - All settings at Once"''', if you choose this option, you will enter an Edition page, the way the settings on this page end, is the exact way the settings will be applied to all the DIDs selected for edition. Be careful, as the final settings from the Edition page will be applied exactly as you see them, even those settings you did not change, will be replaced for the final configuration of the Edition page. That is if you select a [[Voicemail]], all the DIDs will use the same [[Voicemail]], if you leave a blank field like the "Caller ID prefix", all of the DIDs will have this setting blank.	+	'''{ID}''' The ID of the SMS message.
-	This option is useful if you want all your DIDs with the exact same configuration for each one of the settings, including the NOTE.	+	'''{TIMESTAMP}''' The date and time the message was received.
		+	'''{FROM}''' The phone number that sent you the message
		+	'''{TO}''' The DID Number that received the message
		+	'''{MESSAGE}''' The content of the message
		+	'''Example''': http: //mysite.com/sms.php?to={TO}&from={FROM}&message={MESSAGE}&id={ID}&date={TIMESTAMP}
-	'''"Edit Selection - One Setting at a Time"''', this option allows you to access the Edition page, but this time, every setting will have its own independent "Apply" button, so you can make a change to a specific setting, without affecting the rest.	+	*'''URL Callback Retry''': When selected, we will be expecting an "ok" output (without quotes) from your URL callback page as an indicator that you have received the message correctly. If we don't received the "ok" (without quotes) from your callback page, we will keep sending you the same message every 30 minutes.
-	This option is useful if you already have your DIDs configured with different settings, and you need to set only a specific setting for all of them. By doing it this way, the rest of the settings from the DIDs will remain untouched.	+
-	[[category:guides]]	+	Once you configure the desired option, click on Apply Changes.
		+
		+	== Send and Receive Messages ==
		+
		+	===SMS Message Center===
		+
		+	To start using the service you will need to use the SMS Message Center, from your portal >> DID Numbers >> [https://www.voip.ms/m/sms.php SMS Message Center].
		+
		+	For Mobile Devices please use [https://sms.voip.ms/ sms.voip.ms] as a complete all in one solution.
		+
		+	From the SMS Message Center you can check your SMS History, send and receive SMS messages.
		+
		+	[[File:SMS.png]]
		+
		+	*'''Search Range''': Select a Date Range of your SMS History. You can select a time period by marking the "Show Details" field and the text messages will be displayed.
		+
		+	*'''Search Filter''': You can filter your Search by DID, Contact and Type (Sent, Received and Both).
		+
		+	*'''Send New SMS Messages''': Another window will open by clicking here in order to create a new SMS Message.
		+
		+	*'''Delete Selected Messages''': This action will delete any messages that you have selected, by clicking on the box next to them. '''This action cannot be undone.'''
		+
		+	*'''Delete All Messages''': Delete ALL your SMS Messages, both sent and received. '''This action cannot be undone.'''
		+
		+	*'''Checking a Message''': To check a received SMS Message just click it directly in order to display the information.
		+
		+	====Create a New SMS Message====
		+
		+	[[File:SMS41.png]]
		+
		+	You can create a new '''SMS Message''' we will explain you all the parameters you can find on this section:
		+
		+	* '''DID''': If you have more than one DID Number you can select any of the numbers available to send your message.
		+	* '''Contact''': The destination phone number or if you have a [[Phone book|Phone book entry]] start typing the name and the system will display the information if available.
		+	* '''Message''': You can create your message on that field, please note that you have up to 160 characters.
		+
		+	Then click on 'Send Message' to send the SMS.

---

Revision as of 20:57, 7 June 2017

Short Message Service (SMS). This feature will allow you to send and receive messages with your DID Number (US and Canada DID Numbers Only). Currently it is in beta and will remain free until further notice.

Please note that this feature is for regular customer usage. No automation, telemarketing, bulk sending or receiving will be allowed.

Contents 1 Important information to know about the SMS Service 2 Identifying a SMS DID Number 3 Configuring the SMS service 4 Send and Receive Messages 4.1 SMS Message Center 4.1.1 Create a New SMS Message

Important information to know about the SMS Service

• The SMS Service is in BETA version, that means it is not fully deployed. It is important to us that you report any issues with this service by sending an email to [email protected] so that the developers can get involved if necessary.

• The SMS Service will be free until further notice.

• The SMS Service is only available for US and Canadian local DID Numbers marked with the distinctive SMS Icon.

• The SMS Service can only be used to send SMS Messages to Canadian and US 10 digit numbers at this time. We also cannot guarantee that International SMS will be properly received.

• VoIP.ms reserves the right, at its sole discretion, to limit or disable the SMS service from any account that may present marketing patterns / automation patterns / bulk sending or receiving while the service is free and in beta.

• At this time we cannot guarantee that Short Code SMS Messages, which are usually 6 digits or less (e.g.: Skype, Bank Codes, TV Commercials etc...), will work.

• We cannot guarantee that accents or special characters including non Latin letters will be properly delivered.

• For Ported In Numbers: The SMS Functionality will be available up to 48 hours after the porting process is marked as Completed.

• IMPORTANT: At this time, it is not possible to use a softphone to send or receive messages with our SMS Feature. This has to be done through the SMS Message Center in the Customer Portal at DID Numbers >> SMS Message Center in the Customer Portal or through https://sms.voip.ms

If you have further questions don't hesitate to contact the Support Staff on the Live Chat or Ticket System.

Identifying a SMS DID Number

The first thing you need to know is that this feature is only available for local US and Canadian numbers at the moment. You will note that some numbers will have a little icon of a phone device, this indicates that the number supports SMS. Please note that not all locations support SMS at this time.

You can start ordering a DID Number from your portal >> DID Numbers >> Order DID >> Local Numbers >> (US or Canada) Numbers and you will be able to purchase your desired number, just make sure it supports the SMS feature.

Configuring the SMS service

Once purchased the SMS Service needs to be activated on the DID settings, from your portal >> DID Numbers >> Manage DID >> Edit Selection >> SMS.

On that section you can activate and configure some forward options for the SMS service.

The first action to take is to mark the Short Message Service (SMS) service, by enabling this field the SMS Service will be active and free until further notice.

• VoIP.ms SMS Portal: This is enabled by default and it can't be modified, that means that you will be able to create and send messages from the SMS Message Center.

• SMS Email Address: By activating this option all the SMS Messages will be sent to the email address you configure in this field. The advantage of this option is that you will receive your SMS Messages directly to your email and you will be able to Reply to these messages from your email too. You just need to click on reply to the email. Please note that e-mail responses are as well limited to 160 characters and if they exceed this limit, they'll be split in two (or more messages if applies) when sent.

 To reply the SMS Message via your email it is important to click on Reply and DON'T change or modify the destination mail "TO"  
 ([email protected])and the subject E.G [#USXXX] Message sent to 5555555555.

• SMS Forward: You can have your SMS Messages forwarded to your cellphone or any other number that supports SMS, with this option you will receive the SMS Messages from our system to the configured phone number.

 The CallerID sent to the Call Forwarded Cell Phone will be your DID Number that received the SMS Message.

• SMS URL Callback: By enabling this option you will be able to send the messages to another destination e.g. your own server. If selected SMS Messages received by your DID will Send a GET request to the URL Callback provided. Available variables for your URL:

 {ID} The ID of the SMS message.
 {TIMESTAMP} The date and time the message was received.
 {FROM} The phone number that sent you the message
 {TO} The DID Number that received the message
 {MESSAGE} The content of the message
 Example: http: //mysite.com/sms.php?to={TO}&from={FROM}&message={MESSAGE}&id={ID}&date={TIMESTAMP}

• URL Callback Retry: When selected, we will be expecting an "ok" output (without quotes) from your URL callback page as an indicator that you have received the message correctly. If we don't received the "ok" (without quotes) from your callback page, we will keep sending you the same message every 30 minutes.

Once you configure the desired option, click on Apply Changes.

Send and Receive Messages

SMS Message Center

To start using the service you will need to use the SMS Message Center, from your portal >> DID Numbers >> SMS Message Center.

For Mobile Devices please use sms.voip.ms as a complete all in one solution.

From the SMS Message Center you can check your SMS History, send and receive SMS messages.

• Search Range: Select a Date Range of your SMS History. You can select a time period by marking the "Show Details" field and the text messages will be displayed.

• Search Filter: You can filter your Search by DID, Contact and Type (Sent, Received and Both).

• Send New SMS Messages: Another window will open by clicking here in order to create a new SMS Message.

• Delete Selected Messages: This action will delete any messages that you have selected, by clicking on the box next to them. This action cannot be undone.

• Delete All Messages: Delete ALL your SMS Messages, both sent and received. This action cannot be undone.

• Checking a Message: To check a received SMS Message just click it directly in order to display the information.

Create a New SMS Message

You can create a new SMS Message we will explain you all the parameters you can find on this section:

• DID: If you have more than one DID Number you can select any of the numbers available to send your message.
• Contact: The destination phone number or if you have a Phone book entry start typing the name and the system will display the information if available.
• Message: You can create your message on that field, please note that you have up to 160 characters.

Then click on 'Send Message' to send the SMS.