From Bright Pattern Documentation
|
|
| (4 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | <translate>
| + | #REDIRECT [[Api]] |
| − | = Admin Configuration =
| |
| − | The SMS/MMS API needs to be enabled for your contact center before it can be used.
| |
| − | | |
| − | == Procedure ==
| |
| − | To use the SMS/MMS API, your contact center administrator must take the following steps:
| |
| − | | |
| − | === Step 1: Grant the ''Use SMS/MMS API'' privilege for a role ===
| |
| − | In the Contact Center Administrator application, section ''Users & Teams > Roles > Properties'', enable the ''Service and Campaign Administration'' privilege called [[Contact-center-administrator-guide/Privileges#Service_and_Campaign_Administration_group | Use SMS/MMS API]] for a particular role (e.g., "Administrator")
| |
| − | | |
| − | | |
| − | [[File:Service-Use-SMS-API-2-53.png|thumb|800px|center|Service and Campaign Administration privileges]]
| |
| − | | |
| − | | |
| − | === Step 2: Define a user with the role that has the privilege ===
| |
| − | Add a user and give him or her the role (e.g., "System Administrator") with the ''Use SMS/MMS API'' privilege.
| |
| − | | |
| − | | |
| − | [[File:Superadmin1.PNG|thumb|800px|center|Users > Roles]]
| |
| − | | |
| − | | |
| − | === Step 3: Get the ''client_secret'' ===
| |
| − | Generate an API secret for the user and copy it. The API secret is the ''client_secret'' (i.e., the credentials for the user). For example, if your API secret is "ABC" then your ''client_secret'' is "ABC."
| |
| − | | |
| − | | |
| − | [[File:Superadmin2.PNG|thumb|800px|center|Users > Properties]]
| |
| − | | |
| − | | |
| − | === Step 4: Use the user credentials to request access token ===
| |
| − | [[Tenant-management-api-specification/RequestAccessToken | Request an access token]] (see the ''Tenant Management API Specification''), being sure to paste the user's API secret you just generated into the '''client_secret''' field of your access token request.
| |
| − | | |
| − | Fill in these parameters:
| |
| − | * '''client_id''' - The user role that has the ''Use SMS/MMS API'' privilege
| |
| − | * '''client_secret''' - The API secret you generated for the user
| |
| − | * '''grant_type''' - This will always be "client_credentials"
| |
| − | * '''scope''' - The name of your host or tenant (e.g., "example.com")
| |
| − | | |
| − | | |
| − | [[File:Request1-53.png|thumb|800px|center|Example request]]
| |
| − | | |
| − | | |
| − | The access token response will include the access token and type, which is what you use to access the desired resource (e.g., the SMS/MMS API method Get Message).
| |
| − | | |
| − | === Step 5: Define where SMS/MMS messages will go ===
| |
| − | In the properties for [[Contact-center-administrator-guide/AccessNumbers | access numbers]] of type "text-out," specify whether unsolicited SMS/MMS messages will go to the service or the API.
| |
| − | | |
| − | | |
| − | [[File:Superadmin3.PNG|thumb|800px|center|Users > Properties]] | |
| − | | |
| − | | |
| − | | |
| − | </translate>
| |
Latest revision as of 16:13, 5 August 2024
