Talkative supports automated user provisioning and deprovisioning via SCIM, using role-based permissions.
This guide assumes you have already set up SSO integration with your roles correctly mapped. If not, please complete that first using the SSO / Single Sign On Configuration guide.
Setup is straightforward and should take no longer than 10 minutes. You will need an API token, which is valid for 12 months before it must be renewed. Only an Account Holder can perform this setup.
1. Generate an API Token
- Log in to your Talkative Engage account.
- Go to Settings → API Keys.
- Create a new key by giving it a name (for your internal reference).
- Copy the token somewhere safe — it is shown only once.
2. Open Your Azure Enterprise Application
- In the Azure Portal, open the Enterprise Application you created during your SSO setup.
- In the left-hand menu under Manage, select Provisioning.
You should now see the provisioning overview screen.
3. Change Provisioning Mode to Automatic
- Click Get Started.
- Change the provisioning mode from Manual to Automatic.
- Additional fields will now appear.
Fill in the following:
- Tenant URL:
https://{yourregion}.engage.app/api/scim/v1/
Replace {yourregion} with the correct region for your Engage environment.
- Secret Token:
Enter the API token you generated earlier.
Click Save to continue.
4. Disable Group Provisioning (Optional)
The Talkative SCIM endpoint supports Users only, not Groups.
You can disable Group provisioning in this section if you wish. In some cases, Azure may require completing the attribute mapping before the option becomes editable.
5. Add Role Mapping
You must configure Azure to send a user’s role to Talkative Engage.
- Add a new mapping with the following settings:
- Mapping type: Expression
- Expression:
- Target attribute:
userType - Apply this mapping: Always
SingleAppRoleAssignment([appRoleAssignments])Save your changes.
6. Start Provisioning
After saving, you will return to the provisioning page.
- Click Start Provisioning to begin syncing users.
- You may also use Provision on demand to test your configuration and confirm that provisioning works correctly.
Azure will then automatically create, update, and remove users in Talkative Engage according to your directory assignments.
