SharpenDB
Overview
SharpenDB is Sharpen's built-in database tool that allows administrators to create and manage custom data tables directly within the Sharpen platform. Tables can be structured with custom column names and field types to match your organization's specific data needs. Data can be entered manually, imported in bulk via CSV, and exported at any time for reporting or external use.
SharpenDB serves as a flexible data layer that can be connected to other areas of the Sharpen platform, most notably Logic+ flows, enabling dynamic, data-driven routing and automation based on the information stored in your tables.
Example Use Cases
SharpenDB tables can be used in a wide variety of ways depending on your organization's needs. Below are some common examples:
Caller Block List
Create a table containing phone numbers that should be blocked. Build a Logic+ flow that compares an incoming caller's number against the table at the start of the flow. If a match is found, the flow can disconnect the call, play a message, or route it to a designated handling path, all without any agent involvement.
Store and manage outbound campaign contacts in a SharpenDB table. OmniOut reads directly from the table to determine which contacts to reach out to, at what stage of the campaign, and through which owner or queue.
Customer Data Lookup
Populate a table with customer account information and use a Logic+ flow to look up a caller's details in real time. The retrieved data can then be passed to an agent's screen pop, used to personalize routing decisions.
Navigating to SharpenDB
Access SharpenDB using the link that corresponds to your Sharpen environment:
Creating a New Table
Click New Table in the top-left corner of the SharpenDB interface.
Enter a name for the table that clearly identifies its purpose.
Click Structure to begin defining the table's columns.
Click Add Column to add each field. For each column, specify a Field Name and Field Type appropriate to the data it will hold.
Before importing a large dataset via CSV, add a single row of data manually and then export the table first. This generates a correctly formatted CSV template with the exact column headers your table expects, eliminating the risk of mapping errors during import.
Common Field Types
Field Type | Description |
|---|---|
| Whole numbers. Used for numeric identifiers and boolean-style fields. |
| Text values. Used for names, phone numbers, email addresses, and other string data. |
| A small integer, commonly used as a boolean field (0 = false, 1 = true). |
| Date and time values. Used for timestamps and scheduled fields. |
Adding Data to a Table
Data can be added to a SharpenDB table in two ways:
Manually
Open your table and click the Data tab.
Click Add Row and enter the values for each field.
Via CSV Import
Prepare your CSV file using the correct column headers that match your table structure.
Use the import option within the table to upload the file.
The id column is present by default and should not be deleted. It serves as a unique identifier for each row and allows records to be updated on re-import rather than creating duplicates. For example, a contact with an ID of 1 can be re-uploaded at any time to update that row with the most current information.
Exporting Data
To export your table data, click the Export button within the table and select Generate New Report. Once the report has been generated, it will appear in the list below. Click the report to download it as a CSV file.
Additional Information
Default Limits
The following limits apply per organization by default:
Limit | Value |
|---|---|
Maximum number of custom tables | 5 |
Maximum columns per table | 50 |
Maximum rows per table | 250,000 |
Supported Field Types
SharpenDB supports the following column data types when configuring custom tables:
inttinyintfloatvarchar(up to 100 characters)datedatetimetimestamp
Query Behavior
To maintain platform performance, the following query constraints apply:
Queries that take longer than 3 seconds to return are automatically terminated.
Timed-out queries return a relevant status code to the requesting application.
API Access
SharpenDB can be accessed and managed via the Sharpen Public API. The following resources are available for reference:
This article is part of a series on Admin Configuration topics.