Jump to content
KAZOOcon: hackathon signup and details here! ×

Emily R

Administrators
  • Posts

    590
  • Joined

Everything posted by Emily R

  1. Enabling the new 3-digit 988 Lifeline Number User Story All Kazoo Platform operators need to implement outgoing calls to 988 to reach the National Suicide Prevention Lifeline in order to comply with the FCC directive to transition all call access by July 16, 2022. Background On July 16, 2020 the FCC voted to reserve 988 as a new 3-digit call number Americans in crisis can call to reach the National Suicide Prevention Lifeline’s network of suicide prevention and mental health crisis counselors. This is akin to the 911 Emergency Hotline; callers dialing 988 will be directed to the existing support number, 1-800-273-8255. These rules apply to VOIP service providers in addition to telecommunications carriers. Some important details include Deployment deadline for this addition is July 16, 2022. All providers must support 10-digit dialing in areas that still support 7-digit dialing, using 988 as the first 3 digits to reach 10. How to Deploy 988 within your KAZOO Platform Below we outline steps for deploying 988 dialing in your account. Hosted Platform Systems If your account uses 2600Hz carriers The 988 Lifeline number has been deployed and is accessible now. If you are using your own carrier on hosted (BYOC) You will need to set this up on your own. Please follow the steps below for Private Cloud and Global Infrastructure accounts. BYOC / Private Cloud / Global Infrastructure Sites If you are using the Hosted Platform and Bring Your Own Carriers or support your own platform as a Private Cloud or Global Infrastructure account. you will want to implement this by adding a “carrier”. To do this, use the Carriers App. Click on the application. If you do not see it ask your administrator. From the home screen, select "Other" to add a new "carrier" You will see the screen below. In the Brand field, select Other, and enter your Other Brand Name, 988 Emergency In the Server field, replace 2.4.5.7.8 with the IP address of a carrier who can process toll-free calls In the Name field, enter 988 Emergency also Under Rules, select Add New Rule, and click on Emergency Dispatcher You will see the screen below In the Prefix field, Enter the Lifeline 10-digit number, +18002738255 In the Type a Test Number field, enter 988 Add the following Custom Regular Expression as shown in the screenshot above: ^988(\d{0})$ SAVE !!! Your new "carrier" should display in your list of carriers. Select the Gear setting to the right of your listed carrier and go to the Advanced Settings tab and select the Audio option Move PCMU audio codecs to the Selected setting. SAVE that setting also Troubleshooting I'm using the Open Source (or older version of KAZOO as a Global Infrastructure installation) and after setting this up it still doesn't go to the dedicated Emergency Carrier. Any ideas? This can happen if the 988 number is defined in the Carrier Rules as emergency, but not included as an emergency classifier in your database. It then is set as "unknown," and will find a carrier that supports unknown classifications. In pre-4.3 versions of KAZOO, you will need to add 988 to the emergency classifier file in your database. NOTE: This kind of modification requires expert knowledge of how these databases work and can cause serious issues if not entered correctly. Please consider reaching out to support for details. To check your classifier file, you can run this command sudo sup kapps_config get_json number_manager classifiers and search the results for the emergency classifier values. If it is not there you will need to add it. Frequently Asked Questions: Is there a test number I can use to make sure my settings are correct? We are not aware of one at this time. Once this is implemented does the 10-digit phone number 1-800-273-8255 still work if called? Yes. This number will remain operational during the transition process and after July 16, 2022 I'm using the Open Source platform and can't seem to get a dedicated Emergency Carrier process to work. Any ideas? This can happen if the 988 number is classified as "unknown." In pre-5.x versions of KAZOO, you may need to modify the classifier file in your database to include 988 as an emergency dispatch number. NOTE: This kind of modification requires expert knowledge of how these databases work and can cause serious issues if not edited correctly. Please consider reaching out to support for details. References FCC Announcement is HERE #### View full File
  2. Enabling the new 3-digit 988 Lifeline Number User Story All Kazoo Platform operators need to implement outgoing calls to 988 to reach the National Suicide Prevention Lifeline in order to comply with the FCC directive to transition all call access by July 16, 2022. Background On July 16, 2020 the FCC voted to reserve 988 as a new 3-digit call number Americans in crisis can call to reach the National Suicide Prevention Lifeline’s network of suicide prevention and mental health crisis counselors. This is akin to the 911 Emergency Hotline; callers dialing 988 will be directed to the existing support number, 1-800-273-8255. These rules apply to VOIP service providers in addition to telecommunications carriers. Some important details include Deployment deadline for this addition is July 16, 2022. All providers must support 10-digit dialing in areas that still support 7-digit dialing, using 988 as the first 3 digits to reach 10. How to Deploy 988 within your KAZOO Platform Below we outline steps for deploying 988 dialing in your account. Hosted Platform Systems If your account uses 2600Hz carriers The 988 Lifeline number has been deployed and is accessible now. If you are using your own carrier on hosted (BYOC) You will need to set this up on your own. Please follow the steps below for Private Cloud and Global Infrastructure accounts. BYOC / Private Cloud / Global Infrastructure Sites If you are using the Hosted Platform and Bring Your Own Carriers or support your own platform as a Private Cloud or Global Infrastructure account. you will want to implement this by adding a “carrier”. To do this, use the Carriers App. Click on the application. If you do not see it ask your administrator. From the home screen, select "Other" to add a new "carrier" You will see the screen below. In the Brand field, select Other, and enter your Other Brand Name, 988 Emergency In the Server field, replace 2.4.5.7.8 with the IP address of a carrier who can process toll-free calls In the Name field, enter 988 Emergency also Under Rules, select Add New Rule, and click on Emergency Dispatcher You will see the screen below In the Prefix field, Enter the Lifeline 10-digit number, +18002738255 In the Type a Test Number field, enter 988 Add the following Custom Regular Expression as shown in the screenshot above: ^988(\d{0})$ SAVE !!! Your new "carrier" should display in your list of carriers. Select the Gear setting to the right of your listed carrier and go to the Advanced Settings tab and select the Audio option Move PCMU audio codecs to the Selected setting. SAVE that setting also Troubleshooting I'm using the Open Source (or older version of KAZOO as a Global Infrastructure installation) and after setting this up it still doesn't go to the dedicated Emergency Carrier. Any ideas? This can happen if the 988 number is defined in the Carrier Rules as emergency, but not included as an emergency classifier in your database. It then is set as "unknown," and will find a carrier that supports unknown classifications. In pre-4.3 versions of KAZOO, you will need to add 988 to the emergency classifier file in your database. NOTE: This kind of modification requires expert knowledge of how these databases work and can cause serious issues if not entered correctly. Please consider reaching out to support for details. To check your classifier file, you can run this command sudo sup kapps_config get_json number_manager classifiers and search the results for the emergency classifier values. If it is not there you will need to add it. Frequently Asked Questions: Is there a test number I can use to make sure my settings are correct? We are not aware of one at this time. Once this is implemented does the 10-digit phone number 1-800-273-8255 still work if called? Yes. This number will remain operational during the transition process and after July 16, 2022 I'm using the Open Source platform and can't seem to get a dedicated Emergency Carrier process to work. Any ideas? This can happen if the 988 number is classified as "unknown." In pre-5.x versions of KAZOO, you may need to modify the classifier file in your database to include 988 as an emergency dispatch number. NOTE: This kind of modification requires expert knowledge of how these databases work and can cause serious issues if not edited correctly. Please consider reaching out to support for details. References FCC Announcement is HERE ####
  3. Is it possible to provision a phone not listed in auto provisioner ? In theory, any SIP phone can work as a very basic phone, it is not recommended by 2600Hz as it likely means you will have limited functionality and upgrades could cause issues. If you have a specific phone model from a manufacturer (for example Polycomm) that is not listed but similar models are, you may be able to get it working. If however, an entire manufacturer's phone inventory is not listed it's likely that manufacturer has a proprietary setup and does not allow alternate platforms to recognize it (for example, Avaya). View full File
  4. Hi -- If you are logged in as a customer, you will have access shortly!
  5. WL: Smart PBX User Guide View File This is an editable, MS Word version of our smartPBX user guide, found HERE. We recommend you: Check the online version link above for any updates and changes. Edits are made real-time online, less often to the download file. Swap out the 2600hz logo with yours. Look for Video call outs, and either add links of your own or remove the notification. Check the pagination / page breaks. Save as a .pdf file with your personal branding. If you have additions, edits, enhanced screenshots and/or suggestions for improving this document, please add them as a comment at the bottom of the web-based version using the link above. Submitter Emily R Submitted 07/13/2020 Category White Label User Guides  
  6. WL: Comm.io video conferencing user guide View File This is an editable, MS Word version of our comm.io video conferencing user guide, found HERE. We recommend you: Check the online version link above for any updates and changes. Edits are made real-time online, less often to the download file. Swap out the 2600hz logo with yours Check the pagination / page breaks Save as a .pdf file with your personal branding If you have additions, edits, enhanced screenshots and/or suggestions for improving this document, please add them as a comment at the bottom of the web-based version using the link above. Submitter Emily R Submitted 07/13/2020 Category White Label User Guides  
  7. WL: comm.io user guide View File This is an editable, MS Word version of our comm.io User Guide found HERE We recommend you: Check the online version link above for any updates and changes. Edits are made real-time online, less often to the download file. Swap out the 2600hz logo with yours Check the pagination / page breaks Save as a .pdf file with your personal branding If you have additions, edits, enhanced screenshots and/or suggestions for improving this document, please add them as a comment at the bottom of the web-based version using the link above. Submitter Emily R Submitted 07/13/2020 Category White Label User Guides  
  8. WL: comm.io webphone setup guide View File This is an editable, MS Word version of our comm.io webphone setup guide, found HERE. We recommend you: Check the online version link above for any updates and changes. Edits are made real-time online, less often to the download file. Swap out the 2600Hz logo with yours Check the pagination / page breaks Save as a .pdf file with your personal branding If you have additions, edits, enhanced screenshots and/or suggestions for improving this document, please add them as a comment at the bottom of the web-based version using the link above. Submitter Emily R Submitted 07/13/2020 Category White Label User Guides
  9. WL: comm.io installation and setup guide View File This is an editable, MS Word version of our comm.io Setup Guide found HERE. We recommend you: Check the online version link above for any updates and changes. Edits are made real-time online, less often to the download file. Swap out the 2600hz logo with yours Check the pagination / page breaks Save as a .pdf file with your personal branding If you have additions, edits, enhanced screenshots and/or suggestions for improving this document, please add them as a comment at the bottom of the web-based version using the link above. Submitter Emily R Submitted 07/13/2020 Category White Label User Guides  
  10. wow, this is great, thanks for contributing to the community and for sharing your knowledge! Not sure if you all have seen this (sorry Darren if I steal your thunder) but we've created a home for these kinds of videos and training materials here on our website. We'd love to see you all contribute files and/or links here as a common library. Check it out here (under the support link on the main community menu) https://forums.2600hz.com/forums/files/. To the right is a menu showing a bucket for Community Contributions -- click on that category to share your files. This is accessible to resellers / customers only. We're also uploading white label versions of our docs you can swap our our logo and repurpose. Let's collect our expertise and help each other grow! emily p.s. a cool trick: If you select "Follow" on these pages (or any on our site) you will get notified when someone adds a file. Select the down arrow and you'll get a drop-down allowing you to set preferences on how often you want to receive the notifications.
  11. WL: CallThru Setup for Android Devices View File This is an editable, MS Word version of our CallThru.us Setup Guide for Android devices, found HERE. This version is editable using Word. We recommend you: Check the online version link above for any updates and changes. Edits are made real-time online, less often to the download file. Swap out the 2600hz logo with yours Check the pagination / page breaks Save as a .pdf file with your personal branding If you have additions, edits, enhanced screenshots and/or suggestions for improving this document, please add them as a comment at the bottom of the web-based version using the link above. Submitter Emily R Submitted 07/10/2020 Category White Label User Guides  
  12. WL: CallThru.us Setup for iOs Devices View File This is an editable, MS Word version of our CallThru.us Setup Guide for iOs devices, found HERE. This version is editable using Word. We recommend you: Check the online version link above for any updates and changes. Edits are made real-time online, less often to the download file. Swap out the 2600hz logo with yours Check the pagination / page breaks Save as a .pdf file with your personal branding If you have additions, edits, enhanced screenshots and/or suggestions for improving this document, please add them as a comment at the bottom of the web-based version using the link above. Submitter Emily R Submitted 07/10/2020 Category White Label User Guides  
  13. WL: CCPro User Guide View File This is a White Label version of the CCPro User Guide, found online here. It is in Word format, available for you to edit. Once you download it, you can Swap out the 2600Hz logo in the header for your own Double-check the spacing, font, and pagination, as Word can display differently depending on your version and platform NOTE: You will likely want to review and compare this download with the online version to see any updates have been made there. It may be more current. Submitter Emily R Submitted 07/10/2020 Category White Label User Guides  
  14. User Story Set up a user account and possible sub-accounts for your clients. How it works KAZOO is designed to support a Master account (often the Reseller Master) and a hierarchy of sub-accounts. The Account Manager Wizard steps you through the basic steps for creating each account. NOTE: It is recommended the master account is used only to manage the sub accounts and that your personal office account should be created as a sub-account also. Before you start Your Account setup process will ask some technical questions that may have long-standing consequences related to how your applications and calling infrastructure is installed. Please take a moment to read through this before you start, and to consider the following: Do you plan to white-label your account? If so, complete the branding and DNS mapping process that is available in our branding app before you set up the accounts. This way the account realm and other default pathing structures will be inherited. For more information and a user guide on setting up white label URLs and branding, check our Branding App documents, HERE. Will you be setting up sub-accounts? If you want to create sub-accounts, it’s a good idea to map out your naming conventions and strategy ahead of time. One strategy people use is to include the sub-account name as part of the account realm naming string. (see below). What Service Plan will you be using for this account? If you are an administrator, you will be asked to identify the service plan you want to use for this account. How do you want to set an initial credit balance for this account? Setting up an initial balance for each account is required to support per-minute calling and inbound international calls. While you work in the Wizard Use the left NEXT button to step through the setup process. If you need to go back to an earlier section, ONLY use the navigation bar to the left to move back and forth between sections. If you try to use your browser’s back button it will not recognize your last window within the application. Your new account will not officially be created and saved until you finish the wizard. LET'S START! Opening Page This is the opening page for the Account Wizard. As it states, select the Add New Account button to the left to start a new account. General Settings Add Account Information Enter the core information for your account. Notes: Account Name Generally best to use the company’s name, a shortened version of their name or an acronym from their name. A DID does not provide easy recognition of who the account belongs to. It will also be used in reports and will be used on the login page by all users of that account. So simple, short and recognizable are recommended. Physical Address Information You MUST include a physical address for each account you create. Account Realm Value The Account Realm will be used by all the account’s phones in registrations and potentially for sending faxes. By default, the realm is auto-generated by the Create Account Wizard and is a domain name that will be matched by wildcard A and MX DNS records. The first part of the auto-generated name is a random string, like “8dfjd6”. If you are managing multiple accounts, it may make sense to rename the string so you can identify each account separately. Remember, if you are planning on setting up white label / custom branding DNS values, you will want to do that before you set this value and copy your newly created realm. Add Administrators Administrators have additional access to applications and some settings, including setting up new users, assigning access rights, adding devices for users, and activating application access for their account members. Choose a user from the company that you are creating the account for that will have access to managing all internal aspects of their account and be able to see everything for all the users. Note: This is an optional step. Users can be designated Admins via the user settings in SmartPBX or the Account App. Account Contacts Enter the contact information you want related to this account. Technical Contact Assign your first point of support for technical questions here. Billing Contact This information will be used to send usage and related billing summaries. Select Next Service Plan This section will be visible only if you are set up as an administrator for the account. Choose a service plan for your account. Once you have chosen one or more plans, you will see a summary of the billing rate that will be charged. Usage + Call Restrictions Trunk Limits Trunk limits define how many calls can be sent and/or received simultaneously. An incoming Trunk Limit set at 4 for example, means that only 4 incoming calls will be handled at once. Any additional calls will be directed to an automated response. A Trunk is like a physical phone line. Only one call can be active for each trunk. Inbound Trunks can only handle calls inbound from a carrier, Outbound Trunks can only handle calls outbound to a carrier, and Twoway Trunks can handle calls to or from a carrier just like a physical phone line. Trunks only apply to calls to US and Canada numbers. If a call for an account is not able to use a trunk because it is outside the US or Canada or all the account’s trunks are already in use, the call can be applied per minute charges against their active balance. Inbound defines how many simultaneous calls you can receive to your phone system Outbound defines how many simultaneous calls you can send (call out) from your phone system Two-way Trunks defines how many total concurrent calls your platform can handle at one time. Allow customers to make per-minute calls If selected and the trunk limit is met then a customer can still call in and your account will be charged on a per-minute basis. In addition, some calls require a per-minute charge depending on your service plan. These can include: Inbound toll-free calls International calls if allowed NOTE: For more information on trunks and pay-per minute please go here: https://forums.2600hz.com/forums/kazoo-platform-guides/get-started/sip-trunks-and-legacy-pbxes/over-subscription-for-trunking-and-per-minute-services-r16/ Call Restrictions This is where you can define limits on where your agents can make calls. By default, all calling capabilities are enabled for new accounts. If you wish to place call restrictions on this new account, toggle the slider to off. US DID This is your traditional service provided by KAZOO in the US. It refers to the US Direct Inward Dial phone service that is used by PBX systems. The feature allows for multiple telephone numbers over one or more analog or digital physical circuits to the PBX, and transmits the dialed telephone number to the PBX so that a PBX extension is directly accessible for an outside caller, possibly by-passing an auto-attendant. Unknown This is the default rule that matches any number NOT matched by the other rules. IE: if it's not a “US DID” or a “US Toll” or “US Tollfree” etc, then its type is “unknown”. For example, the unknown numbers include extensions like “7903” or the feature code “*97” because those numbers don’t match the other rules. NOTES: Emergency dispatch must be kept on according to the new Kari’s Law requirements. Credit Balance and Features Account Credit This is where you can set your monthly credit balance. You must maintain a current balance for international, per-minute calls, inbound toll-free, caller ID and other system features that incur an additional charge. NOTE: Depending on your contract with your customers you may want to use trunks and per minute credit in a way to reduce you and your customer’s exposure to fraud. See for more options on how to use trunks and minutes together HERE. Control Center Access This is where you can manage general features for the account. You are able to restrict which Control Center features are accessible to this new account. Select the desired features, or leave them all available depending on your business use case and this account's needs. It is suggested only the USER, ACCOUNT, and MISC. options are selected for subaccounts. User Allows users to adjust preferences Account Enables additional controls, including to view/change account name, account realm, technical contact, account timezone/language preferences. NOTE these settings can break a setup so make sure it is available only to trained users. Credit Card Allows users to view and change billing contact and credit card information. Usage Charges Exposes the “per minute” tab of Usage Charges to users for credit and minutes Service Plan Allows users to view/download a copy of the Service Plan associated with the account. Transactions Allows users to view the Transactions log Trunking Inbound Enables inbound trunking Outbound Enables outbound trunking Two Way Enables two-way trunking Misc UI Errors Log Exposes errortracker log. If enabled, the error log will display as a menu option in the Account Control Center. Applications Restrictions Define Access to applications This is where you enable access to the applications. NOTES You must also enable the application within the Application Exchange process once you start up the account. There may be additional fees for some of these applications. Make sure you understand how this will affect your client billing structure. If you select Restricted Access, you will need to manually add the applications you want to enable for this account. Manually adding access to applications (not recommended) If you select Restricted Access above, you will see the added screen below. This is where you enable access to the applications. Review your selections Once you’ve selected your applications, you well see them displayed on your Restrictions page, as shown below. You can remove an application by selecting the trash icon shown in the upper right. You can add more applications by selecting the add application button at the bottom. NOTES: At a minimum, you will need to select SmartPBX Once you select an app, it will display at the top You can search for specific applications using the search button, or filter your listing by using the menu to the left. To “unselect” an app, click on it again. Review, Print and Confirm The last step in this process is to review and confirm your settings. NOTES: To edit a section, select the pencil editor next to each heading. That section will open and be available for editing. We strongly recommend you PRINT your summary by using the printer icon at the top right of the page. This will be a useful reference when you are working on the account in the future. CREATE YOUR ACCOUNT! Once you have reviewed and edited your settings, select Create Account! This can take a while as the application is generating several files. Once it’s created, you will see your new Account Home Page. You can navigate to and update each section for editing using the top tabs You can select the gear to the right of each section to edit the specific field shown. Editing Account Settings The page above summarizes. your account settings. Each gear to the right allows administrators to edit global settings for the account. In addition, there are the following tabs above to make edits: Limits Allows you to view/change. your trunk limits and call restrictions. Control Center Access Allows you to select what settings your customers can view. Numbers Features Toggles to Enable/Disable numbers' features. Carrier View/Update your carrier preference. Notes This provides you with a WYSIWYG editor for creating an pop-up announcement page that appears when users log in. App Exchange View/Enable specific apps for this account. Frequently Asked Questions How do I create a sub-account? If you want to create a sub-account, for different field offices for example, first highlight the main account from the home page listing and then select “Add Account”. Can I change the Trunk Limits value any time if I discover what I enter is not appropriate? Yes, once your account is created, you can manage your trunking settings from the account’s Control Center page. If I manually enable applications during this setup can I return to this and add more later? Yes. Once your account is generated, you can select the App Exchange tab at the top of the main page and enable additional applications from there. Related Articles Set up a White Label DNS for your Accounts SmartPBX: Overview of the Dashboard API Reference Docs docs.2600hz.com Accounts API - Kazoo API Reference REST API Reference for Kazoo Crossbar API docs.2600hz.com Whitelabeling - Kazoo API Reference REST API Reference for Kazoo Crossbar API ####### View full File
  15. User Story Set up a user account and possible sub-accounts for your clients. How it works KAZOO is designed to support a Master account (often the Reseller Master) and a hierarchy of sub-accounts. The Account Manager Wizard steps you through the basic steps for creating each account. NOTE: It is recommended the master account is used only to manage the sub accounts and that your personal office account should be created as a sub-account also. Before you start Your Account setup process will ask some technical questions that may have long-standing consequences related to how your applications and calling infrastructure is installed. Please take a moment to read through this before you start, and to consider the following: Do you plan to white-label your account? If so, complete the branding and DNS mapping process that is available in our branding app before you set up the accounts. This way the account realm and other default pathing structures will be inherited. For more information and a user guide on setting up white label URLs and branding, check our Branding App documents, HERE. Will you be setting up sub-accounts? If you want to create sub-accounts, it’s a good idea to map out your naming conventions and strategy ahead of time. One strategy people use is to include the sub-account name as part of the account realm naming string. (see below). What Service Plan will you be using for this account? If you are an administrator, you will be asked to identify the service plan you want to use for this account. How do you want to set an initial credit balance for this account? Setting up an initial balance for each account is required to support per-minute calling and inbound international calls. While you work in the Wizard Use the left NEXT button to step through the setup process. If you need to go back to an earlier section, ONLY use the navigation bar to the left to move back and forth between sections. If you try to use your browser’s back button it will not recognize your last window within the application. Your new account will not officially be created and saved until you finish the wizard. LET'S START! Opening Page This is the opening page for the Account Wizard. As it states, select the Add New Account button to the left to start a new account. General Settings Add Account Information Enter the core information for your account. Notes: Account Name Generally best to use the company’s name, a shortened version of their name or an acronym from their name. A DID does not provide easy recognition of who the account belongs to. It will also be used in reports and will be used on the login page by all users of that account. So simple, short and recognizable are recommended. Physical Address Information You MUST include a physical address for each account you create. Account Realm Value The Account Realm will be used by all the account’s phones in registrations and potentially for sending faxes. By default, the realm is auto-generated by the Create Account Wizard and is a domain name that will be matched by wildcard A and MX DNS records. The first part of the auto-generated name is a random string, like “8dfjd6”. If you are managing multiple accounts, it may make sense to rename the string so you can identify each account separately. Remember, if you are planning on setting up white label / custom branding DNS values, you will want to do that before you set this value and copy your newly created realm. Add Administrators Administrators have additional access to applications and some settings, including setting up new users, assigning access rights, adding devices for users, and activating application access for their account members. Choose a user from the company that you are creating the account for that will have access to managing all internal aspects of their account and be able to see everything for all the users. Note: This is an optional step. Users can be designated Admins via the user settings in SmartPBX or the Account App. Account Contacts Enter the contact information you want related to this account. Technical Contact Assign your first point of support for technical questions here. Billing Contact This information will be used to send usage and related billing summaries. Select Next Service Plan This section will be visible only if you are set up as an administrator for the account. Choose a service plan for your account. Once you have chosen one or more plans, you will see a summary of the billing rate that will be charged. Usage + Call Restrictions Trunk Limits Trunk limits define how many calls can be sent and/or received simultaneously. An incoming Trunk Limit set at 4 for example, means that only 4 incoming calls will be handled at once. Any additional calls will be directed to an automated response. A Trunk is like a physical phone line. Only one call can be active for each trunk. Inbound Trunks can only handle calls inbound from a carrier, Outbound Trunks can only handle calls outbound to a carrier, and Twoway Trunks can handle calls to or from a carrier just like a physical phone line. Trunks only apply to calls to US and Canada numbers. If a call for an account is not able to use a trunk because it is outside the US or Canada or all the account’s trunks are already in use, the call can be applied per minute charges against their active balance. Inbound defines how many simultaneous calls you can receive to your phone system Outbound defines how many simultaneous calls you can send (call out) from your phone system Two-way Trunks defines how many total concurrent calls your platform can handle at one time. Allow customers to make per-minute calls If selected and the trunk limit is met then a customer can still call in and your account will be charged on a per-minute basis. In addition, some calls require a per-minute charge depending on your service plan. These can include: Inbound toll-free calls International calls if allowed NOTE: For more information on trunks and pay-per minute please go here: https://forums.2600hz.com/forums/kazoo-platform-guides/get-started/sip-trunks-and-legacy-pbxes/over-subscription-for-trunking-and-per-minute-services-r16/ Call Restrictions This is where you can define limits on where your agents can make calls. By default, all calling capabilities are enabled for new accounts. If you wish to place call restrictions on this new account, toggle the slider to off. US DID This is your traditional service provided by KAZOO in the US. It refers to the US Direct Inward Dial phone service that is used by PBX systems. The feature allows for multiple telephone numbers over one or more analog or digital physical circuits to the PBX, and transmits the dialed telephone number to the PBX so that a PBX extension is directly accessible for an outside caller, possibly by-passing an auto-attendant. Unknown This is the default rule that matches any number NOT matched by the other rules. IE: if it's not a “US DID” or a “US Toll” or “US Tollfree” etc, then its type is “unknown”. For example, the unknown numbers include extensions like “7903” or the feature code “*97” because those numbers don’t match the other rules. NOTES: Emergency dispatch must be kept on according to the new Kari’s Law requirements. Credit Balance and Features Account Credit This is where you can set your monthly credit balance. You must maintain a current balance for international, per-minute calls, inbound toll-free, caller ID and other system features that incur an additional charge. NOTE: Depending on your contract with your customers you may want to use trunks and per minute credit in a way to reduce you and your customer’s exposure to fraud. See for more options on how to use trunks and minutes together HERE. Control Center Access This is where you can manage general features for the account. You are able to restrict which Control Center features are accessible to this new account. Select the desired features, or leave them all available depending on your business use case and this account's needs. It is suggested only the USER, ACCOUNT, and MISC. options are selected for subaccounts. User Allows users to adjust preferences Account Enables additional controls, including to view/change account name, account realm, technical contact, account timezone/language preferences. NOTE these settings can break a setup so make sure it is available only to trained users. Credit Card Allows users to view and change billing contact and credit card information. Usage Charges Exposes the “per minute” tab of Usage Charges to users for credit and minutes Service Plan Allows users to view/download a copy of the Service Plan associated with the account. Transactions Allows users to view the Transactions log Trunking Inbound Enables inbound trunking Outbound Enables outbound trunking Two Way Enables two-way trunking Misc UI Errors Log Exposes errortracker log. If enabled, the error log will display as a menu option in the Account Control Center. Applications Restrictions Define Access to applications This is where you enable access to the applications. NOTES You must also enable the application within the Application Exchange process once you start up the account. There may be additional fees for some of these applications. Make sure you understand how this will affect your client billing structure. If you select Restricted Access, you will need to manually add the applications you want to enable for this account. Manually adding access to applications (not recommended) If you select Restricted Access above, you will see the added screen below. This is where you enable access to the applications. Review your selections Once you’ve selected your applications, you well see them displayed on your Restrictions page, as shown below. You can remove an application by selecting the trash icon shown in the upper right. You can add more applications by selecting the add application button at the bottom. NOTES: At a minimum, you will need to select SmartPBX Once you select an app, it will display at the top You can search for specific applications using the search button, or filter your listing by using the menu to the left. To “unselect” an app, click on it again. Review, Print and Confirm The last step in this process is to review and confirm your settings. NOTES: To edit a section, select the pencil editor next to each heading. That section will open and be available for editing. We strongly recommend you PRINT your summary by using the printer icon at the top right of the page. This will be a useful reference when you are working on the account in the future. CREATE YOUR ACCOUNT! Once you have reviewed and edited your settings, select Create Account! This can take a while as the application is generating several files. Once it’s created, you will see your new Account Home Page. You can navigate to and update each section for editing using the top tabs You can select the gear to the right of each section to edit the specific field shown. Editing Account Settings The page above summarizes. your account settings. Each gear to the right allows administrators to edit global settings for the account. In addition, there are the following tabs above to make edits: Limits Allows you to view/change. your trunk limits and call restrictions. Control Center Access Allows you to select what settings your customers can view. Numbers Features Toggles to Enable/Disable numbers' features. Carrier View/Update your carrier preference. Notes This provides you with a WYSIWYG editor for creating an pop-up announcement page that appears when users log in. App Exchange View/Enable specific apps for this account. Frequently Asked Questions How do I create a sub-account? If you want to create a sub-account, for different field offices for example, first highlight the main account from the home page listing and then select “Add Account”. Can I change the Trunk Limits value any time if I discover what I enter is not appropriate? Yes, once your account is created, you can manage your trunking settings from the account’s Control Center page. If I manually enable applications during this setup can I return to this and add more later? Yes. Once your account is generated, you can select the App Exchange tab at the top of the main page and enable additional applications from there. Related Articles Set up a White Label DNS for your Accounts SmartPBX: Overview of the Dashboard API Reference Docs docs.2600hz.com Accounts API - Kazoo API Reference REST API Reference for Kazoo Crossbar API docs.2600hz.com Whitelabeling - Kazoo API Reference REST API Reference for Kazoo Crossbar API #######
  16. 2600HZ USER GUIDE -- ACCOUNT MANAGER WIZARD User Story Set up a user account and possible sub-accounts for your clients. How it works KAZOO is designed to support a Master account (often the Reseller Master) and a hierarchy of sub-accounts. The Account Manager Wizard steps you through the basic steps for creating each account. NOTE: It is recommended the master account is used only to manage the sub accounts and that your personal office account should be created as a sub-account also. Before you start Your Account setup process will ask some technical questions that may have long-standing consequences related to how your applications and calling infrastructure is installed. Please take a moment to read through this before you start, and to consider the following: Do you plan to white-label your account? If so, complete the branding and DNS mapping process that is available in our branding app before you set up the accounts. This way the account realm and other default pathing structures will be inherited. For more information and a user guide on setting up white label URLs and branding, check our Branding App documents, HERE. Will you be setting up sub-accounts? If you want to create sub-accounts, it’s a good idea to map out your naming conventions and strategy ahead of time. One strategy people use is to include the sub-account name as part of the account realm naming string. (see below). What Service Plan will you be using for this account? If you are an administrator, you will be asked to identify the service plan you want to use for this account. How do you want to set an initial credit balance for this account? Setting up an initial balance for each account is required to support per-minute calling and inbound international calls. While you work in the Wizard Use the left NEXT button to step through the setup process. If you need to go back to an earlier section, ONLY use the navigation bar to the left to move back and forth between sections. If you try to use your browser’s back button it will not recognize your last window within the application. Your new account will not officially be created and saved until you finish the wizard. LET'S START! Opening Page This is the opening page for the Account Wizard. As it states, select the Add New Account button to the left to start a new account. General Settings Add Account Information Enter the core information for your account. Notes: Account Name Generally best to use the company’s name, a shortened version of their name or an acronym from their name. A DID does not provide easy recognition of who the account belongs to. It will also be used in reports and will be used on the login page by all users of that account. So simple, short and recognizable are recommended. Physical Address Information You MUST include a physical address for each account you create. Account Realm Value The Account Realm will be used by all the account’s phones in registrations and potentially for sending faxes. By default, the realm is auto-generated by the Create Account Wizard and is a domain name that will be matched by wildcard A and MX DNS records. The first part of the auto-generated name is a random string, like “8dfjd6”. If you are managing multiple accounts, it may make sense to rename the string so you can identify each account separately. Remember, if you are planning on setting up white label / custom branding DNS values, you will want to do that before you set this value and copy your newly created realm. Add Administrators Administrators have additional access to applications and some settings, including setting up new users, assigning access rights, adding devices for users, and activating application access for their account members. Choose a user from the company that you are creating the account for that will have access to managing all internal aspects of their account and be able to see everything for all the users. Note: This is an optional step. Users can be designated Admins via the user settings in SmartPBX or the Account App. Account Contacts Enter the contact information you want related to this account. Technical Contact Assign your first point of support for technical questions here. Billing Contact This information will be used to send usage and related billing summaries. Select Next Service Plan This section will be visible only if you are set up as an administrator for the account. Choose a service plan for your account. Once you have chosen one or more plans, you will see a summary of the billing rate that will be charged. Usage + Call Restrictions Trunk Limits Trunk limits define how many calls can be sent and/or received simultaneously. An incoming Trunk Limit set at 4 for example, means that only 4 incoming calls will be handled at once. Any additional calls will be directed to an automated response. A Trunk is like a physical phone line. Only one call can be active for each trunk. Inbound Trunks can only handle calls inbound from a carrier, Outbound Trunks can only handle calls outbound to a carrier, and Twoway Trunks can handle calls to or from a carrier just like a physical phone line. Trunks only apply to calls to US and Canada numbers. If a call for an account is not able to use a trunk because it is outside the US or Canada or all the account’s trunks are already in use, the call can be applied per minute charges against their active balance. Inbound defines how many simultaneous calls you can receive to your phone system Outbound defines how many simultaneous calls you can send (call out) from your phone system Two-way Trunks defines how many total concurrent calls your platform can handle at one time. Allow customers to make per-minute calls If selected and the trunk limit is met then a customer can still call in and your account will be charged on a per-minute basis. In addition, some calls require a per-minute charge depending on your service plan. These can include: Inbound toll-free calls International calls if allowed NOTE: For more information on trunks and pay-per minute please go here: https://forums.2600hz.com/forums/kazoo-platform-guides/get-started/sip-trunks-and-legacy-pbxes/over-subscription-for-trunking-and-per-minute-services-r16/ Call Restrictions This is where you can define limits on where your agents can make calls. By default, all calling capabilities are enabled for new accounts. If you wish to place call restrictions on this new account, toggle the slider to off. US DID This is your traditional service provided by KAZOO in the US. It refers to the US Direct Inward Dial phone service that is used by PBX systems. The feature allows for multiple telephone numbers over one or more analog or digital physical circuits to the PBX, and transmits the dialed telephone number to the PBX so that a PBX extension is directly accessible for an outside caller, possibly by-passing an auto-attendant. Unknown This is the default rule that matches any number NOT matched by the other rules. IE: if it's not a “US DID” or a “US Toll” or “US Tollfree” etc, then its type is “unknown”. For example, the unknown numbers include extensions like “7903” or the feature code “*97” because those numbers don’t match the other rules. NOTES: Emergency dispatch must be kept on according to the new Kari’s Law requirements. Credit Balance and Features Account Credit This is where you can set your monthly credit balance. You must maintain a current balance for international, per-minute calls, inbound toll-free, caller ID and other system features that incur an additional charge. NOTE: Depending on your contract with your customers you may want to use trunks and per minute credit in a way to reduce you and your customer’s exposure to fraud. See for more options on how to use trunks and minutes together HERE. Control Center Access This is where you can manage general features for the account. You are able to restrict which Control Center features are accessible to this new account. Select the desired features, or leave them all available depending on your business use case and this account's needs. It is suggested only the USER, ACCOUNT, and MISC. options are selected for subaccounts. User Allows users to adjust preferences Account Enables additional controls, including to view/change account name, account realm, technical contact, account timezone/language preferences. NOTE these settings can break a setup so make sure it is available only to trained users. Credit Card Allows users to view and change billing contact and credit card information. Usage Charges Exposes the “per minute” tab of Usage Charges to users for credit and minutes Service Plan Allows users to view/download a copy of the Service Plan associated with the account. Transactions Allows users to view the Transactions log Trunking Inbound Enables inbound trunking Outbound Enables outbound trunking Two Way Enables two-way trunking Misc UI Errors Log Exposes errortracker log. If enabled, the error log will display as a menu option in the Account Control Center. Applications Restrictions Define Access to applications This is where you enable access to the applications. NOTES You must also enable the application within the Application Exchange process once you start up the account. There may be additional fees for some of these applications. Make sure you understand how this will affect your client billing structure. If you select Restricted Access, you will need to manually add the applications you want to enable for this account. Manually adding access to applications (not recommended) If you select Restricted Access above, you will see the added screen below. This is where you enable access to the applications. Review your selections Once you’ve selected your applications, you well see them displayed on your Restrictions page, as shown below. You can remove an application by selecting the trash icon shown in the upper right. You can add more applications by selecting the add application button at the bottom. NOTES: At a minimum, you will need to select SmartPBX Once you select an app, it will display at the top You can search for specific applications using the search button, or filter your listing by using the menu to the left. To “unselect” an app, click on it again. Review, Print and Confirm The last step in this process is to review and confirm your settings. NOTES: To edit a section, select the pencil editor next to each heading. That section will open and be available for editing. We strongly recommend you PRINT your summary by using the printer icon at the top right of the page. This will be a useful reference when you are working on the account in the future. CREATE YOUR ACCOUNT! Once you have reviewed and edited your settings, select Create Account! This can take a while as the application is generating several files. Once it’s created, you will see your new Account Home Page. You can navigate to and update each section for editing using the top tabs You can select the gear to the right of each section to edit the specific field shown. Frequently Asked Questions How do I create a sub-account? If you want to create a sub-account, for different field offices for example, first highlight the main account from the home page listing and then select “Add Account”. Can I change the Trunk Limits value any time if I discover what I enter is not appropriate? Yes, once your account is created, you can manage your trunking settings from the account’s Control Center page. If I manually enable applications during this setup can I return to this and add more later? Yes. Once your account is generated, you can select the App Exchange tab at the top of the main page and enable additional applications from there. Related Articles White Labeling your Accounts API Reference Docs docs.2600hz.com Accounts API - Kazoo API Reference REST API Reference for Kazoo Crossbar API docs.2600hz.com Whitelabeling - Kazoo API Reference REST API Reference for Kazoo Crossbar API @@@@@@@ ####### API Reference Docs Related Articles API Reference Docs docs.2600hz.com Resources - Kazoo API Reference REST API Reference for Kazoo Crossbar API ####### $$$$$$$$$$$$$$ #### View full File
  17. Moving an account within KAZOO User Stories I mistakenly added and configured a sub account under the wrong parent account; my “North Carolina” office should be under “East” and not “West.” I want to move a sub account from one home account to another parent account – for example, move my XXX East account from US to Canada? Overview There are two ways to achieve this: Use the Cluster Manager app. In the KAZOO environment. Execute an SSH command at the server level. This is an option available to Global Infrastructure clients who are experienced system administrators. NOTE: This process can be unsafe; it should only be used if an account was created under the wrong account in error, and needs to be moved. USING CLUSTER MANAGER (OPTION 1) Obtain the account ID of the account you want to move from. This ID will referenced as MOVE_ACCOUNT from now on. This can be obtained from the UI via the Accounts Manager app. Open your Accounts app Navigate to the account you want to move to Select the account, and select Overview Copy the account ID String and save it on a notepad From Account: 2. Obtain the account ID of the account you want to move the MOVE_ACCOUNT TO This ID will be referenced as DESTINATION_ACCOUNT from now on. Repeat the steps above and copy to a place that clearly labels this Account ID is the TO: Account ID number. 3. Browse to https://ui.zswitch.net and login using your credentials and the name of your account on our hosted platform (XYZ Parent Account) Open the Apps menu, and select the Cluster Manager app Click the Scripts tab from within the Cluster Manager app Click the Red Button labeled Run Command 4. Type the command below into the command dialog box sup crossbar_maintenance move_account MOVE_ACCOUNT DESTINATION_ACCOUNT NOTE: While this process should take less than 5 seconds, you may want to increase the “Abort After” value to about 5 minutes. This should give ample time for the process to resolve before timing out and requiring a restart. 6. Click the Select Servers button 7. From the Cluster drop down, select the name of the cluster where the accounts live that you would like to move (pre, or prod). You do not need to select anything for Zone, or Services 8. Uncheck servers in the Filter Results section, so that you ONLY HAVE ONE server checked NOTE: You MUST select the server that contains your KAZOO applications; a Freeswitch or Database only server will cause this process to fail. To ensure this, you can follow these steps: Filter your server list using kazoo_applications type of servers first. "Select All" to unselect everything. Reselect the first server on the. list. 9. Click NEXT 10. Click Run Tasks Now! to execute the command you typed into the dialog box, on the server that remained checked on the previous page. 11. Watch the "Running/Queued" section of the tasks tab to ensure the task completes. You may need to refresh the list periodically, but clicking the refresh button (2 spinning arrows) at the top of the list. You can also go to the "Completed Logs" section to see that your "Run Command" task completed successfully. 12. Once the task is complete, confirm the account is now moved by re-opening the Accounts Manager app in the UI of your cluster. ADVANCED USERS (OPTION 2) This is an option available to Global Infrastructure clients who are experienced system administrators. Via SSH: Obtain the account ID of the account you want to move, I'll reference this ID as MOVE_ACCOUNT from now on. This can be obtained from the UI via the Accounts Manager app. Obtain the account ID of the account you want to move the MOVE_ACCOUNT under, I will reference this ID as DESTINATION_ACCOUNT from now on. This can also be obtained from the UI via the Accounts Manager app. SSH to one of the servers in your cluster where the account you want to move is assigned, and where kazoo_apps is running. Run the command below: sup crossbar_maintenance move_account MOVE_ACCOUNT DESTINATION_ACCOUNT API Reference Doc: docs.2600hz.com https://docs.2600hz.com/dev/applications/crossbar/doc/accounts/#move-an-account View full File
  18. Moving an account within KAZOO User Stories I mistakenly added and configured a sub account under the wrong parent account; my “North Carolina” office should be under “East” and not “West.” I want to move a sub account from one home account to another parent account – for example, move my XXX East account from US to Canada? Overview There are two ways to achieve this: Use the Cluster Manager app. In the KAZOO environment. Execute an SSH command at the server level. This is an option available to Global Infrastructure clients who are experienced system administrators. NOTE: This process can be unsafe; it should only be used if an account was created under the wrong account in error, and needs to be moved. USING CLUSTER MANAGER (OPTION 1) Obtain the account ID of the account you want to move from. This ID will referenced as MOVE_ACCOUNT from now on. This can be obtained from the UI via the Accounts Manager app. Open your Accounts app Navigate to the account you want to move to Select the account, and select Overview Copy the account ID String and save it on a notepad From Account: 2. Obtain the account ID of the account you want to move the MOVE_ACCOUNT TO This ID will be referenced as DESTINATION_ACCOUNT from now on. Repeat the steps above and copy to a place that clearly labels this Account ID is the TO: Account ID number. 3. Browse to https://ui.zswitch.net and login using your credentials and the name of your account on our hosted platform (XYZ Parent Account) Open the Apps menu, and select the Cluster Manager app Click the Scripts tab from within the Cluster Manager app Click the Red Button labeled Run Command 4. Type the command below into the command dialog box sup crossbar_maintenance move_account MOVE_ACCOUNT DESTINATION_ACCOUNT NOTE: While this process should take less than 5 seconds, you may want to increase the “Abort After” value to about 5 minutes. This should give ample time for the process to resolve before timing out and requiring a restart. 6. Click the Select Servers button 7. From the Cluster drop down, select the name of the cluster where the accounts live that you would like to move (pre, or prod). You do not need to select anything for Zone, or Services 8. Uncheck servers in the Filter Results section, so that you ONLY HAVE ONE server checked NOTE: You MUST select the server that contains your KAZOO applications; a Freeswitch or Database only server will cause this process to fail. To ensure this, you can follow these steps: Filter your server list using kazoo_applications type of servers first. "Select All" to unselect everything. Reselect the first server on the. list. 9. Click NEXT 10. Click Run Tasks Now! to execute the command you typed into the dialog box, on the server that remained checked on the previous page. 11. Watch the "Running/Queued" section of the tasks tab to ensure the task completes. You may need to refresh the list periodically, but clicking the refresh button (2 spinning arrows) at the top of the list. You can also go to the "Completed Logs" section to see that your "Run Command" task completed successfully. 12. Once the task is complete, confirm the account is now moved by re-opening the Accounts Manager app in the UI of your cluster. ADVANCED USERS (OPTION 2) This is an option available to Global Infrastructure clients who are experienced system administrators. Via SSH: Obtain the account ID of the account you want to move, I'll reference this ID as MOVE_ACCOUNT from now on. This can be obtained from the UI via the Accounts Manager app. Obtain the account ID of the account you want to move the MOVE_ACCOUNT under, I will reference this ID as DESTINATION_ACCOUNT from now on. This can also be obtained from the UI via the Accounts Manager app. SSH to one of the servers in your cluster where the account you want to move is assigned, and where kazoo_apps is running. Run the command below: sup crossbar_maintenance move_account MOVE_ACCOUNT DESTINATION_ACCOUNT API Reference Doc: docs.2600hz.com https://docs.2600hz.com/dev/applications/crossbar/doc/accounts/#move-an-account
  19. User Story Reseller wants to store recordings onto Amazon Web Service while insuring as few permissions are given to the service account as is possible. Reseller is looking for a solution that helps ensure strong encryption is implemented for call recording features and connect this account to a specific KAZOO account. Reseller plans to assign each account a unique “bucket” with its unique credentials. Before you Start Sign up and Log in to your Amazon Web Services account. If you don’t have one already you can go to their website here to get started: https://aws.amazon.com/ Quick Overview of Steps Set up an account with Amazon Web Services Decide what clients and client names to use for each bucket Create bucket names for each client and define settings Create user names for each client Add JSON IAM policy and permissions Add JSON Bucket policy and permissions Capture your Access Key ID and Secret Access Key , Bucket Name Open the AWS app Create a new AWS account in KAZOO and enter that information. Set up an S3 Bucket An Amazon S3 (Simple Storage Service) bucket is Amazon’s term for a place you define to store your data and its metadata. It is the equivalent to a file folder with your company identifier on it. From your AWS portal, access the S3 application Select Create Bucket Enter a new Bucket name. You will do this for every client? The Region field can be left blank, AWS will read the account default. Click NEXT and page through the remaining settings options. We recommend enabling the “Block ALL public access” option to on. Set up an IAM User An IAM (Identity and Access Management) User is an entity name and credential that you create in AWS to represent the person or application that uses it to interact with AWS. An IAM user with administrator permissions is not the same thing as the AWS account root user. From your AWS portal, access the IAM application Select Add User Enter a new username. This will likely be your client name or client reference Check the Programmatic Access box under Access Type Select NEXT Under Set Permissions, select “Attach existing policies directly” Select Create Policy This will open a new tab for you to enter your policy details into. A policy defines the AWS permissions that you can assign to a user, group, or role. Yo can create and edit a policy in the visual editor and using JSON. For this example we will use the JSON. Copy the text below. Replace the “BUCKET_NAME_HERE” text string with the bucket name you entered earlier. { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket", "s3:PutObject", "s3:GetObject" ], "Resource": [ "arn:aws:s3:::BUCKET_NAME_HERE/*", "arn:aws:s3:::BUCKET_NAME_HERE" ] } ] } It will display something like below: Review Policy Select Review Policy using the button at the bottom right. Return to the IAM tab and refresh your screen using the refresh button to the right (circled in red). Enter the name of the policy in the search field and select the checkbox to the left of the Policy name it to be active. Select NEXT Go to Set Permissions Boundary, Select NEXT: Tags The next two pages are for tagging and review, you can just leave them blank and click create user. Your access key and secret access key will be displayed. SAVE these! You will need to add these to your connector app. Return to the main page for IAM Click Users, and click on your user account. Save the Amazon Resource Name (ARN) shown. This is your identifier Amazon recognizes. (for more info on these, see HERE.) Enter your bucket policy Return to the S3 app and select the bucket you want to add a policy to. Click on Permissions Click on Bucket Policy Copy / Paste the code below Update your bucket name and ARN (see highlighted area). SAVE !!! You should see confirmation of your updates here. { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "ARN_FOR_IAM_USER_HERE" }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:PutObject" ], "Resource": [ "arn:aws:s3:::BUCKET_NAME_HERE/*", "arn:aws:s3:::BUCKET_NAME_HERE" ] } ] } Update your bucket name and ARN (See. highlighted areas). SAVE ! You should see confirmation of your updates here. Enter saved data into your AWS Connector App in KAZOO Click on AWS Connector from your Apps listing NOTE: If you can’t find it right away, use the Search Apps field at the left of the screen. Click Add AWS Account Enter your saved account details NOTE Please input the host name for the zone you used for your S3 bucket. For example, s3.us-west-1.amazonaws.com. A full list of hostnames is available at https://docs.aws.amazon.com/general/latest/gr/s3.html" Frequently Asked Questions When is it important to assign an AWS account to a client? AWS offers storage with enhanced privacy encryption, which is often required for HIPAA compliance and other clients who are concerned about privacy. It also provides automatic backup services to give your client files additional redundancy. If your client is concerned about tight encryption and security, this is an option to consider. What are Bucket and IAM policies? Below is an overview provided by Amazon, here: IAM policies specify what actions are allowed or denied on what AWS resources (e.g. allow ec2:TerminateInstance on the EC2 instance with instance_id=i-8b3620ec). You attach IAM policies to IAM users, groups, or roles, which are then subject to the permissions you’ve defined. In other words, IAM policies define what a principal can do in your AWS environment. S3 bucket policies, on the other hand, are attached only to S3 buckets. S3 bucket policies specify what actions are allowed or denied for which principals on the bucket that the bucket policy is attached to (e.g. allow user Alice to PUT but not DELETE objects in the bucket). Note: You attach S3 bucket policies at the bucket level (i.e. you can’t attach a bucket policy to an S3 object), but the permissions specified in the bucket policy apply to all the objects in the bucket. IAM policies and S3 bucket policies are both used for access control and they’re both written in JSON using the AWS access policy language, so they can be confused. Related Articles Accounts Manager Wizard Notes on HIPAA Compliance Responsibilities API Reference docs.2600hz.com Storage - Kazoo API Reference REST API Reference for Kazoo Crossbar API #### View full File
  20. User Story Reseller wants to store recordings onto Amazon Web Service while insuring as few permissions are given to the service account as is possible. Reseller is looking for a solution that helps ensure strong encryption is implemented for call recording features and connect this account to a specific KAZOO account. Reseller plans to assign each account a unique “bucket” with its unique credentials. Before you Start Sign up and Log in to your Amazon Web Services account. If you don’t have one already you can go to their website here to get started: https://aws.amazon.com/ Quick Overview of Steps Set up an account with Amazon Web Services Decide what clients and client names to use for each bucket Create bucket names for each client and define settings Create user names for each client Add JSON IAM policy and permissions Add JSON Bucket policy and permissions Capture your Access Key ID and Secret Access Key , Bucket Name Open the AWS app Create a new AWS account in KAZOO and enter that information. Set up an S3 Bucket An Amazon S3 (Simple Storage Service) bucket is Amazon’s term for a place you define to store your data and its metadata. It is the equivalent to a file folder with your company identifier on it. From your AWS portal, access the S3 application Select Create Bucket Enter a new Bucket name. You will do this for every client? The Region field can be left blank, AWS will read the account default. Click NEXT and page through the remaining settings options. We recommend enabling the “Block ALL public access” option to on. Set up an IAM User An IAM (Identity and Access Management) User is an entity name and credential that you create in AWS to represent the person or application that uses it to interact with AWS. An IAM user with administrator permissions is not the same thing as the AWS account root user. From your AWS portal, access the IAM application Select Add User Enter a new username. This will likely be your client name or client reference Check the Programmatic Access box under Access Type Select NEXT Under Set Permissions, select “Attach existing policies directly” Select Create Policy This will open a new tab for you to enter your policy details into. A policy defines the AWS permissions that you can assign to a user, group, or role. Yo can create and edit a policy in the visual editor and using JSON. For this example we will use the JSON. Copy the text below. Replace the “BUCKET_NAME_HERE” text string with the bucket name you entered earlier. { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket", "s3:PutObject", "s3:GetObject" ], "Resource": [ "arn:aws:s3:::BUCKET_NAME_HERE/*", "arn:aws:s3:::BUCKET_NAME_HERE" ] } ] } It will display something like below: Review Policy Select Review Policy using the button at the bottom right. Return to the IAM tab and refresh your screen using the refresh button to the right (circled in red). Enter the name of the policy in the search field and select the checkbox to the left of the Policy name it to be active. Select NEXT Go to Set Permissions Boundary, Select NEXT: Tags The next two pages are for tagging and review, you can just leave them blank and click create user. Your access key and secret access key will be displayed. SAVE these! You will need to add these to your connector app. Return to the main page for IAM Click Users, and click on your user account. Save the Amazon Resource Name (ARN) shown. This is your identifier Amazon recognizes. (for more info on these, see HERE.) Enter your bucket policy Return to the S3 app and select the bucket you want to add a policy to. Click on Permissions Click on Bucket Policy Copy / Paste the code below Update your bucket name and ARN (see highlighted area). SAVE !!! You should see confirmation of your updates here. { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "ARN_FOR_IAM_USER_HERE" }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:PutObject" ], "Resource": [ "arn:aws:s3:::BUCKET_NAME_HERE/*", "arn:aws:s3:::BUCKET_NAME_HERE" ] } ] } Update your bucket name and ARN (See. highlighted areas). SAVE ! You should see confirmation of your updates here. Enter saved data into your AWS Connector App in KAZOO Click on AWS Connector from your Apps listing NOTE: If you can’t find it right away, use the Search Apps field at the left of the screen. Click Add AWS Account Enter your saved account details NOTE Please input the host name for the zone you used for your S3 bucket. For example, s3.us-west-1.amazonaws.com. A full list of hostnames is available at https://docs.aws.amazon.com/general/latest/gr/s3.html" Frequently Asked Questions When is it important to assign an AWS account to a client? AWS offers storage with enhanced privacy encryption, which is often required for HIPAA compliance and other clients who are concerned about privacy. It also provides automatic backup services to give your client files additional redundancy. If your client is concerned about tight encryption and security, this is an option to consider. What are Bucket and IAM policies? Below is an overview provided by Amazon, here: IAM policies specify what actions are allowed or denied on what AWS resources (e.g. allow ec2:TerminateInstance on the EC2 instance with instance_id=i-8b3620ec). You attach IAM policies to IAM users, groups, or roles, which are then subject to the permissions you’ve defined. In other words, IAM policies define what a principal can do in your AWS environment. S3 bucket policies, on the other hand, are attached only to S3 buckets. S3 bucket policies specify what actions are allowed or denied for which principals on the bucket that the bucket policy is attached to (e.g. allow user Alice to PUT but not DELETE objects in the bucket). Note: You attach S3 bucket policies at the bucket level (i.e. you can’t attach a bucket policy to an S3 object), but the permissions specified in the bucket policy apply to all the objects in the bucket. IAM policies and S3 bucket policies are both used for access control and they’re both written in JSON using the AWS access policy language, so they can be confused. Related Articles Accounts Manager Wizard Notes on HIPAA Compliance Responsibilities API Reference docs.2600hz.com Storage - Kazoo API Reference REST API Reference for Kazoo Crossbar API ####
  21. Configuring Video for use on the KAZOO Platform User Stories A user wants to enable a device so it supports video calling between two office desk phones A user wants to call into a KAZOO video conference using a video-enabled desk phone instead of a laptop. A user wants to allow video replay and/or online streaming on an office phone (to replay a saved video call for example) using the KAZOO platform. Overview Video Calling Video is an image capture process that takes a rapid amount of still pictures at a source, compresses the data, and transmits the packet across phone lines. The recipient unpacks them and replays the sequence to show movement, or “video.” Some notes about the transmission: “Frames” are single images, transmission is described in “frames per second”, or FPS. Typical compression is 20-30 frames per second. Lower rates and lower resolution means you will see a stuttered, jagged result. The resulting “video” is a stream of these captures. As with any images, video takes up significant data bandwidth to transmit. To help mitigate this video uses one of several compression algorithms which collectively are referred to as “CODECS” (short for “COder-DECoder”). CODECS Compression CODECS refers to the format for compressed data transmitted across devices (including WebRTC, Softphones, mobile devices, comm.io). Some formats compress audio only, others compress audio and video. There are several different compression types available today. To successfully transmit these files, both the originating device and the receiving device must be equipped with the same codec compression interpreter. If a device transmits H264 video, then the receiver must be able to “read” that. Your office desk phone and your laptop application for example, must be able to talk in the same language. Common audio formats used by telco devices include .mp3 and Opus. Popular compression formats for video are H263, H264, and the newer Google-developed VP8. Audio and the KAZOO Platform All KAZOO Platform calls assume (and require) audio CODECS. Audio is typically set by default, and users can fine tune those settings in either our Provisioner setup or the SmartPBX app. KAZOO includes support for the most common audio formats. This audio information will be sent to the corresponding phone hardware so the two are synchronized. Video and the KAZOO Platform Video is optional as its transmission takes considerably more bandwidth and can lead to an additional charge to your account. To support independent control over video, the KAZOO platform transmits audio and video on separate ports for each call. In order for the sending and receiving devices to share video, they must both recognize the same CODECS data. This requires an intentional setup in both SmartPBX and the Provisioner app. Enabling Video Calls To use video, you will need to enable it for your devices in your user account. This is a two step process. Since the call origination device (whoever starts the call) is what picks the algorithm, or the “rules.” As your system will do both, you will need to provide available compression settings for both sending and receiving instances: Server to Phone (using SmartPBX) and Phone to Server (using Provisioner) Below is an illustration summarizing the process. Before you start Confirm the video format(s) that are supported by your devices. The most common include H261, H263, H264 and VP8. CONFIGURE VIDEO SETTINGS FOR SERVER → PHONE TRANSMISSION This setting is defined in SmartPBX. Here you will define Server to Phone connections. NOTE: If the two settings do not match you will get “incompatible destination” errors. To set these preferences, go into SmartPBX Select the Device tab to the left. Search for your device, and select the Edit icon to its right From that dialog, select the Advanced Tab, and then Video from the drop-down menu. You will see a screen that shows a list of video compression options. Drag the compression types you want to recognize to the Selected column. NOTES: By default, there will be no options in the Selected column. This effectively means video is not enabled. To enable a video type, drag the compression style your devices support to the Selected column. VP8 is currently the most popular, as its compression has the best results and there is no license fee related to it. Most newer devices prefer it for these reasons, so if your devices support it, it’s recommended you use it as your primary selection. You can move more than one codec to the Selected column, and drag them into a preferred priority. SUCCESS !!! You are now ready to move to the Provisioner app and configure the settings there. CONFIGURE VIDEO SETTINGS FOR PHONE → SERVER TRANSMISSION Define the settings for a Phone to Server video transmission in the Provisioner app. This setting defines the transmission codec from the phone to the server. Under the Devices tab, find your phone and select the Settings gear; Choose Configure. Select the Codecs tab from the Blue Menu and review the video preferences. If Video selection isn’t visible, you’ll need to go back to SmartPBX and verify you saved your settings to turn it on. Even if the video is turned on, by default the selection here will be None. If you see a value for “Inherits”, this means the setting will carry down from your parent account. Your selection here MUST MATCH your selection in SmartPBX as you configured above. You can only select Primary, Secondary, and Tertiary types if you have moved each into the Selected column in SmartPBX. SAVE your settings! SELECTING A TYPE OF CALL WHEN YOU DIAL Some phones and web phones allow you to choose whether to make your call an audio-only or a video call. If you do not intend to share video this is a great way to save bandwidth and unnecessary usage fees. On the Bria softphone To the right of the phone # field, you will see a drop-down menu arrow. Select that to choose your phone call mode. If you choose video, a video “screen” will appear. Yealink phones Yealink will ask for audio/video on your screen once you dial the number. NOTE: It’s best to define your type of call at the beginning of your call. While some phones may provide a way to switch mid-call, this may interrupt the call integrity and cause reduced quality and/or a disconnect. HOW KAZOO MANAGES VIDEO CALLS Because video takes significant bandwidth and processing power to compress and decompress, KAZOO has set up dedicated servers to process video calls. ADDITIONAL NOTES Once video is enabled, it typically is used as the default for every call. Newer devices may give you the option as the call is made (see above), so you can choose audio if you do not want to incur extra costs. Older models have a configuration setting that can be set to “optional.” You will need to make sure this is set correctly in the back end configuration. Usually this can be found in the Provisioner app. If you turn on video on as a default in your device, all calls will include the video codec even if the receiver has no video capabilities. This is clearly a waste of bandwidth so it is recommended you find and enable an “optional” setting to trigger the setting for each call. FREQUENTLY ASKED QUESTIONS : VIDEO SETUP What devices does KAZOO support for video? KAZOO supports any device that supports the CODEC options listed in the SmartPBX and Provisioner settings. Currently this includes H261, H263, H264, and VP8. This is typically provided as part of the device specifications. Do I have to configure my comm.io video to use the conferencing there? No. comm.io has automatically configured the video codec in its software. It should work without any added configuration. When I try to use my video I get an error message that says “incompatible destination”. This error is indicating that the CODEC algorithms on the sending and receiving devices do not match. You will need to review the settings for each device and add a matching CODEC in the configuration. If I have vp8 set as primary and H263 set as tertiary on my sending device, and my receiving device only has H263 set, will the call connect? Yes. As long as the codec has been moved to Selected in SmartPBX under your device, it won’t matter which is primary, secondary or tertiary. Those priorities will kick in only if multiple options exist. Typically it makes sense to select VP8 as the primary as it has the most efficient compression and therefore will likely incur less charges. My device settings in Provisioner say “inherited”. Where from? This references a parent account setting. If you have a hierarchy of accounts, it comes from the account, or reseller, or system defaults – whichever one is found first (in that order). Does the order (primary, secondary, etc) of the video selection(s) I add in Smart PBX have to match the order I enter in Provisioner or do they just need to be enabled in both places? As long as the codec has been moved to Selected in SmartPBX under your device, it won’t matter which is primary, secondary or tertiary. Those priorities will kick in only if multiple options exist. Do I need to configure these settings for mobile phones? Mobile phones are pre-configured for both audio and video. Phone browsers often choose a codec and then optimize it for best use of battery life and resolution for their device. If you cannot see a video transmitted from a mobile phone on your desktop phone (or vice-versa, and you get a “Can’t play video - video codec not supported) it may be you need to configure the desktop so it supports the mobile phone video codec. Below is what is currently supported: Apple iPhones: H. 264 and their new format for Apple only, HEVC Apple Safari: H. 264 and now also vp8 starting with Safari 12.1 Android Phones: H. 263 / H.264 There are apps available for each operating system that will convert and/or display files using other formats such as VLC Media Player; you can search for these in their app stores. Why do some of my calls cause video errors and others don’t? There are several reasons this could happen. Consider the following as a way to troubleshoot this: Are the calls that are working internal calls within your office? This may be related to your carrier configuration if you have a BYOC account. Refer to the Carrier section above. Is the difference related to incoming v. outgoing calls? Check your configuration and codec assignments in SmartPBX (server to device or incoming) and in Provisioner (device to server, or outgoing). Is it specific to a device type? In some cases a device does not support the video codecs you have configured and/or it may not support video at all, and your calls are sending video requests. Often these issues will provide an error saying “video not supported” or “incompatible destination.” Does the KAZOO CallThru.us mobile app support this video process? Not at this time. Configuring Video for use on the KAZOO Platform Reseller Notes Billing Structure for Video Calls Currently video is currently enabled for all accounts at no additional charge for our introductory beta rollout; once the product is officially released you will be charged $20/video channel. Once we have video call features (such as inviting external participants to video conferences) that significantly increase the video load we will add a setting to the Control Center to manage maximum channels -- similar to the trunking setting. This will mean account managers will be able to distribute charges in a similar manner. How KAZOO detects video calls (back end SIP code) Audio call request is shown in the gray section Additional Video call request is shown below the added gray line BYOC Carrier Configuration If you are using your own carrier it is critical you also assign audio settings. If you do not, the system will assume your devices support both audio and video and will by default try to make video calls. As no 3rd party carriers are supporting video at this time this will cause Outbound calls made from a video phone to a carrier to fail. Calls within an office will work correctly. To configure the carrier settings, go to the Carrier app. And select an account you have created or create a new account. Then select Audio and add specific codecs. Continue with video, even though they are likely not supported. ##### View full File
  22. Configuring Video for use on the KAZOO Platform User Stories A user wants to enable a device so it supports video calling between two office desk phones A user wants to call into a KAZOO video conference using a video-enabled desk phone instead of a laptop. A user wants to allow video replay and/or online streaming on an office phone (to replay a saved video call for example) using the KAZOO platform. Overview Video Calling Video is an image capture process that takes a rapid amount of still pictures at a source, compresses the data, and transmits the packet across phone lines. The recipient unpacks them and replays the sequence to show movement, or “video.” Some notes about the transmission: “Frames” are single images, transmission is described in “frames per second”, or FPS. Typical compression is 20-30 frames per second. Lower rates and lower resolution means you will see a stuttered, jagged result. The resulting “video” is a stream of these captures. As with any images, video takes up significant data bandwidth to transmit. To help mitigate this video uses one of several compression algorithms which collectively are referred to as “CODECS” (short for “COder-DECoder”). CODECS Compression CODECS refers to the format for compressed data transmitted across devices (including WebRTC, Softphones, mobile devices, comm.io). Some formats compress audio only, others compress audio and video. There are several different compression types available today. To successfully transmit these files, both the originating device and the receiving device must be equipped with the same codec compression interpreter. If a device transmits H264 video, then the receiver must be able to “read” that. Your office desk phone and your laptop application for example, must be able to talk in the same language. Common audio formats used by telco devices include .mp3 and Opus. Popular compression formats for video are H263, H264, and the newer Google-developed VP8. Audio and the KAZOO Platform All KAZOO Platform calls assume (and require) audio CODECS. Audio is typically set by default, and users can fine tune those settings in either our Provisioner setup or the SmartPBX app. KAZOO includes support for the most common audio formats. This audio information will be sent to the corresponding phone hardware so the two are synchronized. Video and the KAZOO Platform Video is optional as its transmission takes considerably more bandwidth and can lead to an additional charge to your account. To support independent control over video, the KAZOO platform transmits audio and video on separate ports for each call. In order for the sending and receiving devices to share video, they must both recognize the same CODECS data. This requires an intentional setup in both SmartPBX and the Provisioner app. Enabling Video Calls To use video, you will need to enable it for your devices in your user account. This is a two step process. Since the call origination device (whoever starts the call) is what picks the algorithm, or the “rules.” As your system will do both, you will need to provide available compression settings for both sending and receiving instances: Server to Phone (using SmartPBX) and Phone to Server (using Provisioner) Below is an illustration summarizing the process. Before you start Confirm the video format(s) that are supported by your devices. The most common include H261, H263, H264 and VP8. CONFIGURE VIDEO SETTINGS FOR SERVER → PHONE TRANSMISSION This setting is defined in SmartPBX. Here you will define Server to Phone connections. NOTE: If the two settings do not match you will get “incompatible destination” errors. To set these preferences, go into SmartPBX Select the Device tab to the left. Search for your device, and select the Edit icon to its right From that dialog, select the Advanced Tab, and then Video from the drop-down menu. You will see a screen that shows a list of video compression options. Drag the compression types you want to recognize to the Selected column. NOTES: By default, there will be no options in the Selected column. This effectively means video is not enabled. To enable a video type, drag the compression style your devices support to the Selected column. VP8 is currently the most popular, as its compression has the best results and there is no license fee related to it. Most newer devices prefer it for these reasons, so if your devices support it, it’s recommended you use it as your primary selection. You can move more than one codec to the Selected column, and drag them into a preferred priority. SUCCESS !!! You are now ready to move to the Provisioner app and configure the settings there. CONFIGURE VIDEO SETTINGS FOR PHONE → SERVER TRANSMISSION Define the settings for a Phone to Server video transmission in the Provisioner app. This setting defines the transmission codec from the phone to the server. Under the Devices tab, find your phone and select the Settings gear; Choose Configure. Select the Codecs tab from the Blue Menu and review the video preferences. If Video selection isn’t visible, you’ll need to go back to SmartPBX and verify you saved your settings to turn it on. Even if the video is turned on, by default the selection here will be None. If you see a value for “Inherits”, this means the setting will carry down from your parent account. Your selection here MUST MATCH your selection in SmartPBX as you configured above. You can only select Primary, Secondary, and Tertiary types if you have moved each into the Selected column in SmartPBX. SAVE your settings! SELECTING A TYPE OF CALL WHEN YOU DIAL Some phones and web phones allow you to choose whether to make your call an audio-only or a video call. If you do not intend to share video this is a great way to save bandwidth and unnecessary usage fees. On the Bria softphone To the right of the phone # field, you will see a drop-down menu arrow. Select that to choose your phone call mode. If you choose video, a video “screen” will appear. Yealink phones Yealink will ask for audio/video on your screen once you dial the number. NOTE: It’s best to define your type of call at the beginning of your call. While some phones may provide a way to switch mid-call, this may interrupt the call integrity and cause reduced quality and/or a disconnect. HOW KAZOO MANAGES VIDEO CALLS Because video takes significant bandwidth and processing power to compress and decompress, KAZOO has set up dedicated servers to process video calls. ADDITIONAL NOTES Once video is enabled, it typically is used as the default for every call. Newer devices may give you the option as the call is made (see above), so you can choose audio if you do not want to incur extra costs. Older models have a configuration setting that can be set to “optional.” You will need to make sure this is set correctly in the back end configuration. Usually this can be found in the Provisioner app. If you turn on video on as a default in your device, all calls will include the video codec even if the receiver has no video capabilities. This is clearly a waste of bandwidth so it is recommended you find and enable an “optional” setting to trigger the setting for each call. FREQUENTLY ASKED QUESTIONS : VIDEO SETUP What devices does KAZOO support for video? KAZOO supports any device that supports the CODEC options listed in the SmartPBX and Provisioner settings. Currently this includes H261, H263, H264, and VP8. This is typically provided as part of the device specifications. Do I have to configure my comm.io video to use the conferencing there? No. comm.io has automatically configured the video codec in its software. It should work without any added configuration. When I try to use my video I get an error message that says “incompatible destination”. This error is indicating that the CODEC algorithms on the sending and receiving devices do not match. You will need to review the settings for each device and add a matching CODEC in the configuration. If I have vp8 set as primary and H263 set as tertiary on my sending device, and my receiving device only has H263 set, will the call connect? Yes. As long as the codec has been moved to Selected in SmartPBX under your device, it won’t matter which is primary, secondary or tertiary. Those priorities will kick in only if multiple options exist. Typically it makes sense to select VP8 as the primary as it has the most efficient compression and therefore will likely incur less charges. My device settings in Provisioner say “inherited”. Where from? This references a parent account setting. If you have a hierarchy of accounts, it comes from the account, or reseller, or system defaults – whichever one is found first (in that order). Does the order (primary, secondary, etc) of the video selection(s) I add in Smart PBX have to match the order I enter in Provisioner or do they just need to be enabled in both places? As long as the codec has been moved to Selected in SmartPBX under your device, it won’t matter which is primary, secondary or tertiary. Those priorities will kick in only if multiple options exist. Do I need to configure these settings for mobile phones? Mobile phones are pre-configured for both audio and video. Phone browsers often choose a codec and then optimize it for best use of battery life and resolution for their device. If you cannot see a video transmitted from a mobile phone on your desktop phone (or vice-versa, and you get a “Can’t play video - video codec not supported) it may be you need to configure the desktop so it supports the mobile phone video codec. Below is what is currently supported: Apple iPhones: H. 264 and their new format for Apple only, HEVC Apple Safari: H. 264 and now also vp8 starting with Safari 12.1 Android Phones: H. 263 / H.264 There are apps available for each operating system that will convert and/or display files using other formats such as VLC Media Player; you can search for these in their app stores. Why do some of my calls cause video errors and others don’t? There are several reasons this could happen. Consider the following as a way to troubleshoot this: Are the calls that are working internal calls within your office? This may be related to your carrier configuration if you have a BYOC account. Refer to the Carrier section above. Is the difference related to incoming v. outgoing calls? Check your configuration and codec assignments in SmartPBX (server to device or incoming) and in Provisioner (device to server, or outgoing). Is it specific to a device type? In some cases a device does not support the video codecs you have configured and/or it may not support video at all, and your calls are sending video requests. Often these issues will provide an error saying “video not supported” or “incompatible destination.” Does the KAZOO CallThru.us mobile app support this video process? Not at this time. Configuring Video for use on the KAZOO Platform Reseller Notes Billing Structure for Video Calls Currently video is currently enabled for all accounts at no additional charge for our introductory beta rollout; once the product is officially released you will be charged $20/video channel. Once we have video call features (such as inviting external participants to video conferences) that significantly increase the video load we will add a setting to the Control Center to manage maximum channels -- similar to the trunking setting. This will mean account managers will be able to distribute charges in a similar manner. How KAZOO detects video calls (back end SIP code) Audio call request is shown in the gray section Additional Video call request is shown below the added gray line BYOC Carrier Configuration If you are using your own carrier it is critical you also assign audio settings. If you do not, the system will assume your devices support both audio and video and will by default try to make video calls. As no 3rd party carriers are supporting video at this time this will cause Outbound calls made from a video phone to a carrier to fail. Calls within an office will work correctly. To configure the carrier settings, go to the Carrier app. And select an account you have created or create a new account. Then select Audio and add specific codecs. Continue with video, even though they are likely not supported. #####
  23. Below is an overview of what the SmartPBX dashboard is showing about your account configuration. NOTE: For details on each setting and strategies for how to define them, refer to our companion User Guide that walks through the setup process, HERE. Dashboard Header Information This information provides quick access to some of the main features of your account. The top left displays the account name you are viewing and is read-only. The tabs to the right are clickable and provide access to the following settings: Account Default Caller ID Number Here you can set what number is used as the default Caller ID for outbound calls from the account. You can also set the CNAM and E911 info associated with the number. For more info on CNAM and E911 see the Main Number section below. 911 VERY IMPORTANT: Calls to 911 will not be allowed if one of the DIDs belonging to the account is not configured with proper E911 address information. If the account has multiple physical locations, each location must have its own DID with E911 address information specific to that location. Devices that are not at the location matching the E911 address of the account’s default E911 configured number must specify the correct DID to be used for emergency calls placed from that device so that the 911 call can be handled by the correct 911 call center and so they can if needed send emergency responders to the correct address. If a call to 911 is placed and it is determined that the address is not configured or incorrect there are significant penalty fees charged. If you bring your own carrier (BYOC) then E911 is not managed through Kazoo’s Monster UI and no check can be made to ensure you have E911 address information properly configured for the emergency Caller ID that you have configured. Account Default Hold music (MOH) Set what the account’s default hold music is. It will play when someone is on hold, in a conference room when there is only one person there, if you get Call Center the hold music there. NOTE: This can be over-ruled by add-on applications. For example, the Call Center Pro application provides added choices for uploading music and a sequence of "on hold" interactions, including "approximate waiting time" and "number in queue ahead of you." Hours This allows you to revise the office hours you previously set up. Total Users The total users graph shows the total number of users assigned to this account, and how many, if any have been given access to SMS/MMS messaging. There is an added charge for this so it is helpful to see what the summary here. Total Devices This summarizes the number of devices (not users, remember many users will have more than 1 device) configured for the account. A desk phone is one type of device that is called a “SIP Phone” device type. Not all devices are necessarily themselves a “Phone”. Some can be a static forward to a phone number off net like a Cell Phone or might be an ATA that an old analog phone is connected to. A circle graph representing the percentages of types of devices with a legend showing the actual count of each device type. Unregistered Devices The total number of device that are not currently registered. It will include SIP phones/devices that are not registered and will include device types that by nature do not register like Landline, cell phones, and RTC webphones used in the comm.io app. Conference Bridge count Summarizes the total number of conference bridges set up for this account. Main Number This displays the main numbers and the features active for each number. If you bring your own carrier E911 and Caller ID Name will not be available for you to manage with Kazoo. When you first set up the account there will be a special message here to assign a Main Number. Once you have one assigned, there will be a message to configure E911 for a Main Number. See the Numbers section below for the meaning of the icons like that may appear with a number. Conference Number The account’s conference number if assigned. One of the available user features is to have their own conference room, and/or a video conference room as part of the comm.io app. The user would give out the main conference number and the user’s conference room number along with an optional PIN access code. Main Faxbox Number The account’s Main Faxbox number if assigned. This faxbox only handles inbound faxes and will send inbound faxes to the email address configured when a number is assigned to the Main Faxbox. Total Numbers Summarizes the total Numbers owned by the account and indicates any and spare numbers you may have purchased in a group but not yet assigned. It also identifies 800 numbers you manage. A Graph showing the classification of the Numbers owned by the account. The available classification names can be seen in the Restrictions portion of a device. US DID includes United States and Canadian numbers. Company Directory Shows how many users there are in the company directory. You can configure a user not to be listed in the company directory. But by default, users will be added to the company directory. You can download this information as a .csv file also, and import it into a document for distribution. Account ID This number will be used if you need a support person to help track down call routing issues or any other support questions. Account Realm The realm of the account. This is used as part of SIP authentication and for faxboxes so the account users can send an email to the system that will then be sent as a fax to the destination number. See the Creating Accounts and Branding articles in the Getting Started resources for more info on the significance of the realm and the implications of changing it later. Numbers & Users Below is a quick overview of the pages displayed when you click on the icons in the dashboard. NOTE: A more detailed discussion of these settings can be found in the SmartPBX User guide, HERE. Numbers in use shows the phone numbers, the users assigned to the numbers, and some of the attributes assigned to that number. When a number is selected there are actions displayed above the list of numbers that can be performed on that number. Here the actions for selected numbers are and . In Number Manager App there is also the action which allows you to move a spare number to another account. Be aware, if you move a number to another account and later Delete it from that account the number will go back as a spare number to the account it was previously moved from. If you believe a number is in the wrong place (Spare/In Use) you can use the to try to correct it. Charges for DIDs apply to spare numbers as well as Numbers in use. Meaning of Number Icons like indicates the number was added manually or imported to the system and features like inbound and outbound Caller ID and E911 are not available for it. Generally, this is the case because it is from a BYOC carrier and those features need to be managed through the carrier that the number was bought from. icon when clicked displays a menu that allows you to manage features of the number like Caller ID, CNAM, and E911. E911 is configured on the number. Caller ID name will be looked up for the number the call came from, AKA Inbound CNAM lookup. number has set a name in the national CNAM database that can be looked up by OTHER systems that do Caller ID lookup. This is not to be confused with the External Caller ID Name. The External Caller ID Name is only effective for calls between accounts. The PSTN network does not support transmitting Caller ID information so when a call goes out a carrier across PSTN the Caller ID name is lost. But the destination number’s service provider, like we offer with the “Inbound CNAM lookup” described above, can do a lookup in the national CNAM database and provide that to their users. . indicates the number is in the process of porting. Indicates that the number has been enabled for SMS text messaging Indicates the number has Prepended value to it that will display on caller ID. Spare Numbers Users Here is where you can view and manage the account’s users and the features they have set up. Each Column for the user reflects primary info of that column’s category for that user and you can click it to access the settings for that category for that user. For a detailed description of what the icons represent and how to assign them, refer to the SmartPBX User guide. View full File
  24. Below is an overview of what the SmartPBX dashboard is showing about your account configuration. NOTE: For details on each setting and strategies for how to define them, refer to our companion User Guide that walks through the setup process, HERE. Dashboard Header Information This information provides quick access to some of the main features of your account. The top left displays the account name you are viewing and is read-only. The tabs to the right are clickable and provide access to the following settings: Account Default Caller ID Number Here you can set what number is used as the default Caller ID for outbound calls from the account. You can also set the CNAM and E911 info associated with the number. For more info on CNAM and E911 see the Main Number section below. 911 VERY IMPORTANT: Calls to 911 will not be allowed if one of the DIDs belonging to the account is not configured with proper E911 address information. If the account has multiple physical locations, each location must have its own DID with E911 address information specific to that location. Devices that are not at the location matching the E911 address of the account’s default E911 configured number must specify the correct DID to be used for emergency calls placed from that device so that the 911 call can be handled by the correct 911 call center and so they can if needed send emergency responders to the correct address. If a call to 911 is placed and it is determined that the address is not configured or incorrect there are significant penalty fees charged. If you bring your own carrier (BYOC) then E911 is not managed through Kazoo’s Monster UI and no check can be made to ensure you have E911 address information properly configured for the emergency Caller ID that you have configured. Account Default Hold music (MOH) Set what the account’s default hold music is. It will play when someone is on hold, in a conference room when there is only one person there, if you get Call Center the hold music there. NOTE: This can be over-ruled by add-on applications. For example, the Call Center Pro application provides added choices for uploading music and a sequence of "on hold" interactions, including "approximate waiting time" and "number in queue ahead of you." Hours This allows you to revise the office hours you previously set up. Total Users The total users graph shows the total number of users assigned to this account, and how many, if any have been given access to SMS/MMS messaging. There is an added charge for this so it is helpful to see what the summary here. Total Devices This summarizes the number of devices (not users, remember many users will have more than 1 device) configured for the account. A desk phone is one type of device that is called a “SIP Phone” device type. Not all devices are necessarily themselves a “Phone”. Some can be a static forward to a phone number off net like a Cell Phone or might be an ATA that an old analog phone is connected to. A circle graph representing the percentages of types of devices with a legend showing the actual count of each device type. Unregistered Devices The total number of device that are not currently registered. It will include SIP phones/devices that are not registered and will include device types that by nature do not register like Landline, cell phones, and RTC webphones used in the comm.io app. Conference Bridge count Summarizes the total number of conference bridges set up for this account. Main Number This displays the main numbers and the features active for each number. If you bring your own carrier E911 and Caller ID Name will not be available for you to manage with Kazoo. When you first set up the account there will be a special message here to assign a Main Number. Once you have one assigned, there will be a message to configure E911 for a Main Number. See the Numbers section below for the meaning of the icons like that may appear with a number. Conference Number The account’s conference number if assigned. One of the available user features is to have their own conference room, and/or a video conference room as part of the comm.io app. The user would give out the main conference number and the user’s conference room number along with an optional PIN access code. Main Faxbox Number The account’s Main Faxbox number if assigned. This faxbox only handles inbound faxes and will send inbound faxes to the email address configured when a number is assigned to the Main Faxbox. Total Numbers Summarizes the total Numbers owned by the account and indicates any and spare numbers you may have purchased in a group but not yet assigned. It also identifies 800 numbers you manage. A Graph showing the classification of the Numbers owned by the account. The available classification names can be seen in the Restrictions portion of a device. US DID includes United States and Canadian numbers. Company Directory Shows how many users there are in the company directory. You can configure a user not to be listed in the company directory. But by default, users will be added to the company directory. You can download this information as a .csv file also, and import it into a document for distribution. Account ID This number will be used if you need a support person to help track down call routing issues or any other support questions. Account Realm The realm of the account. This is used as part of SIP authentication and for faxboxes so the account users can send an email to the system that will then be sent as a fax to the destination number. See the Creating Accounts and Branding articles in the Getting Started resources for more info on the significance of the realm and the implications of changing it later. Numbers & Users Below is a quick overview of the pages displayed when you click on the icons in the dashboard. NOTE: A more detailed discussion of these settings can be found in the SmartPBX User guide, HERE. Numbers in use shows the phone numbers, the users assigned to the numbers, and some of the attributes assigned to that number. When a number is selected there are actions displayed above the list of numbers that can be performed on that number. Here the actions for selected numbers are and . In Number Manager App there is also the action which allows you to move a spare number to another account. Be aware, if you move a number to another account and later Delete it from that account the number will go back as a spare number to the account it was previously moved from. If you believe a number is in the wrong place (Spare/In Use) you can use the to try to correct it. Charges for DIDs apply to spare numbers as well as Numbers in use. Meaning of Number Icons like indicates the number was added manually or imported to the system and features like inbound and outbound Caller ID and E911 are not available for it. Generally, this is the case because it is from a BYOC carrier and those features need to be managed through the carrier that the number was bought from. icon when clicked displays a menu that allows you to manage features of the number like Caller ID, CNAM, and E911. E911 is configured on the number. Caller ID name will be looked up for the number the call came from, AKA Inbound CNAM lookup. number has set a name in the national CNAM database that can be looked up by OTHER systems that do Caller ID lookup. This is not to be confused with the External Caller ID Name. The External Caller ID Name is only effective for calls between accounts. The PSTN network does not support transmitting Caller ID information so when a call goes out a carrier across PSTN the Caller ID name is lost. But the destination number’s service provider, like we offer with the “Inbound CNAM lookup” described above, can do a lookup in the national CNAM database and provide that to their users. . indicates the number is in the process of porting. Indicates that the number has been enabled for SMS text messaging Indicates the number has Prepended value to it that will display on caller ID. Spare Numbers Users Here is where you can view and manage the account’s users and the features they have set up. Each Column for the user reflects primary info of that column’s category for that user and you can click it to access the settings for that category for that user. For a detailed description of what the icons represent and how to assign them, refer to the SmartPBX User guide.
×
×
  • Create New...