# Acrobits Configuration for Cisco UCM Tips

This article summarizes a few practical tips for connecting Acrobits applications to **Cisco Unified Communications Manager (Cisco UCM)** as SIP clients. It applies to both **Acrobits Softphone**, the retail softphone application, and **Cloud Softphone**, the Acrobits white-label softphone platform.

Acrobits Softphone requires full manual account configuration in the application. Cloud Softphone account forms and account provisioning are normally prepared during the project POC phase, so some of these values may already be filled in or hidden from the end user.

## Required Values

Prepare the following values before configuring Acrobits Softphone or preparing Cloud Softphone provisioning.

| Value | Description |
| :--- | :--- |
| Line number | Directory number assigned to the Cisco UCM user or third-party SIP device. Use this as the Acrobits SIP username. |
| Digest User ID | Cisco UCM End User assigned as the Digest User on the SIP device. This should match the line number. |
| Digest password | Digest credentials configured in Cisco UCM for the user associated with the SIP device. Use this as the Acrobits SIP password. |
| Registrar IP address or hostname | Cisco UCM node that accepts SIP registrations from the client. |
| SIP transport and port | Transport and port allowed by the Cisco UCM SIP security profile. Common values are UDP or TCP on port `5060`, or TLS on port `5061` if TLS is configured. |

## Cisco UCM Checklist

In Cisco UCM, check the common integration gotchas:

1. Configure the End User assigned as the Digest User on the SIP device so the User ID matches the line number.
2. Set the digest credentials for that user and associate the user with the SIP device that owns the line.
3. Confirm the SIP security profile allows the transport and port you plan to use from the Acrobits client.

Matching the Digest User's User ID to the line number is the easiest step to miss. For example, if the line number is `1234`, configure the Cisco UCM Digest User ID and the Acrobits SIP username as `1234`.

## Acrobits Softphone Account Settings

In Acrobits Softphone, configure the SIP account manually with the Cisco UCM SIP credentials and registrar.

| Acrobits Softphone setting | Cisco UCM value |
| :--- | :--- |
| SIP username | Cisco UCM line number. |
| Auth username | Cisco UCM Digest User ID. Leave empty if the app should use the SIP username and both values match. |
| SIP password | Cisco UCM digest password. |
| Host | Cisco UCM registrar IP address or hostname. |
| Proxy | Optional. Use the Cisco UCM registrar IP address or hostname if your deployment requires an explicit proxy. |
| Transport | Transport configured in the Cisco UCM SIP security profile. |

## Cloud Softphone Provisioning

During the Cloud Softphone POC, Acrobits works with you to define an end-user onboarding workflow that fits your Cisco UCM environment and product requirements.

Cloud Softphone does not consume Cisco UCM device or TFTP templates directly. The app supports [Acrobits External Provisioning](../frameworks/provisioning/external_provisioning.md), so Cisco UCM provisioning data can be wrapped in the Acrobits provisioning format when needed.

External Provisioning is optional. Cloud Softphone can work without it, but end users may need to enter SIP credentials manually if no provisioning source is available.

## Troubleshooting Tips

If registration fails, first verify that the Acrobits SIP username, Cisco UCM user ID, and Cisco UCM line number are the same value. Then confirm that the SIP password in the Acrobits account matches the digest credentials configured in Cisco UCM.

If registration reaches the wrong node or times out, check the registrar IP address or hostname, transport, port, and firewall rules between the client network and Cisco UCM.