The 8x8 integration imports call detail records (CDR) from 8x8 Work through the Analytics for 8x8 Work API and rates them against your tariffs. This page lists what an 8x8 administrator has to set up and hand to PracBill; PracBill configures the import on its side.
| Step | Detail |
|---|---|
| Import CDR | Call records are pulled on a schedule from the /analytics/work/v2/call-records endpoint. |
| Match calls to services | By caller ID, callee number or extension. |
| Rate calls | Against the tariff group set on the customer or the department. |
| Multiple PBXes | CDR is fetched per pbxId, or for every PBX in the tenant. |
The integration is read-only: PracBill fetches call records and changes nothing in your 8x8 tenant.
You will hand PracBill these five items:
| Item | Description |
|---|---|
| 8x8 API Key | Generated in the 8x8 Admin Console under API Keys, for an app of type Analytics for 8x8 Work. |
| API Username | An 8x8 user with access to Analytics for 8x8 Work. |
| API Password | That user's password. |
| PBX ID(s) | One PBX name, a comma-separated list, or allpbxes for every PBX in the tenant. |
| Time Zone | The IANA zone to query data in, e.g. Australia/Melbourne. |
The username and password are the same ones the user would use to log in to Analytics for 8x8 Work in a browser. Use a dedicated user for the integration rather than a real employee's account.
pracbill-api@yourcompany.com.8x8 rejects API calls from a user that has never logged in to Analytics in a browser. Skipping step 6 is the most common cause of "no CDR after setup".
| Permission | Purpose |
|---|---|
| Access to Analytics for 8x8 Work | Required to use the analytics API. |
| Visibility of every PBX to be imported | The user can only query PBXes their role gives them access to. |
A standard analytics or supervisor role is usually enough. If in doubt, use an analytics admin role.
PracBill Integration and save. 8x8 generates a Key and a Secret.8x8-apikey PracBill needs.The Secret is not used for Analytics for 8x8 Work, but keep it private.
allpbxes.Return these through a secure channel (password manager share or encrypted message, not plain email):
| Item | Value |
|---|---|
| 8x8 API Key | From "Generate the API key" |
| API Username | e.g. pracbill-api@yourcompany.com |
| API Password | From "Create the analytics user" |
| PBX ID(s) | Single name, comma list, or allpbxes |
| Time Zone | Australia/Melbourne or your IANA zone |
| Earliest Date | Date to backfill CDR from (maximum 2 years) |
PracBill then configures the integration, runs an initial backfill and confirms with you that calls are importing and rating.
| Issue | Likely cause | Resolution |
|---|---|---|
| No CDR after setup | The API user has never logged in to Analytics in a browser | Log in as that user once, then re-run the import. |
401 Unauthorized in the import log |
Password changed, key regenerated, or user lost Analytics access | Send refreshed credentials to PracBill. |
| Calls appear for the wrong PBX | PBX ID mismatch | Confirm the exact PBX name(s) in the Admin Console. |
| Gaps in older call data | Calls older than 2 years are not retained by 8x8 | None; platform limitation. |
| Calls not matched to a customer | The caller or callee number is not on a service in PracBill | Set the service number on the correct customer's service. |
Unsure about the API key or PBX names? Contact PracBill to arrange a screen-share.
Related: Integrations, Create a rate card.