

This feature lets you establish a process of deciding which templates can be used in communications. By assigning reviewers and an approver, you indicate the users who will be responsible for verifying the quality and correctness of the templates and approving them. 

---


In the decision-making process, a user can have one of the following roles:

-  **Regular user** - A user who isn't a reviewer or an approver. Such a user creates a template and sends it to reviewers to get approval.

- **Reviewer** - Responsible for verifying the template and giving a pre-approval. There is no limit on the number of reviewers in the system. 

- **Approver** - Gives a final approval for a template after the reviewers give their approvals. 

The process involves the following steps:

**Creating a template > Testing > Pre-approval by reviewers > Final approval by an approver**



<div class="admonition admonition-tip"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M9.663 17h4.673M12 3v1m6.364 1.636l-.707.707M21 12h-1M4 12H3m3.343-5.657l-.707-.707m2.828 9.9a5 5 0 117.072 0l-.548.547A3.374 3.374 0 0014 18.469V19a2 2 0 11-4 0v-.531c0-.895-.356-1.754-.988-2.386l-.548-.547z" /></svg></div><div class="admonition-body"><div class="admonition-content">

If you duplicate a template which received an approval, you will need to send the duplicated template to get an approval anyway.

</div></div></div>


## Configuration
---



1. <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/icons/settings-icon.svg" alt="Settings icon" class="icon"> Go to **Settings > Approval services > Add service**.  
    **Result**: A configuration pop-up appears. 
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/servapproval1.png" alt="Configuration form of approval service" class="large">
    <figcaption>Configuration form of approval service</figcaption>
    </figure>  
2. On the pop-up:
    1. In the **Service name** field, type the name of your service. This name will be used only for identification purposes. The service you create will be displayed on the list of services marked with the name you enter here. 
    2. From the **Microservice** dropdown list, choose the microservice within the application you want to design a decision-making process for. For one microservice you can create only 1 approval service.
    3. From the **Approver** dropdown list, assign one approver out of the users who are added to a workspace.  
    An approver is a person who gives a final approval to a message, without it the message cannot be sent.
    4. Add reviewers by clicking **+ Add user**. Similarly to the approver, from the dropdown list, select a user who will act as a reviewer. You can add as many reviewers as you want to.
    Before an approver gives a final approve to the message, the reviewers need to verify and confirm the template. 
    5. If you want the approval of all reviewers to be required before the final approval from the approver, select the **All reviewers have to approve** checkbox. If this option is unselected, approval from only one reviewer is required before the final approval.
    4. Confirm the settings by clicking **Save**.

## The approval flow
---

### Regular user perspective

1. The first step is creating a template by a regular user. Go to **Experience Hub** and when creating any type of communication, create a new template. In the upper-right corner, click **Send to approval** to send the template to reviewers. 
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/regular-user-send-to-approval.png" alt="Send to approval" class="full">
    <figcaption> Send to approval </figcaption>
    </figure>  
2. Then the template is checked by reviewers. 
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/regular-user-preapproval.png" alt="Pre-approval" class="full">
    <figcaption> Pre-approval </figcaption>
    </figure>  
3. In this stage all reviewers have approved the template and a user awaits for a final approve. 
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/sent-to-final-approve.png" alt="Sent to final approval" class="full">
    <figcaption> Pre-approval </figcaption>
    </figure>
4. The final approval is granted and the user may send the message.  
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/regular-user-approved.png" alt="Approved" class="full">
    <figcaption> Approved </figcaption>
    </figure>

### Reviewer perspective 

1. A reviewer can check the list of message templates sent to be approved in **Settings > Approval Requests**.
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/servapproval6.png" alt="A list of approval requests" class="full">
    <figcaption> A list of approval requests </figcaption>
    </figure>
2. The reviewer goes to the **Templates** folder (it is available in the message type in the **Experience Hub** feature) and accepts or rejects the templates that await for the review. When the reviewer decides to unapprove the template, then they can write reasons for this decision. 
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/servapproval4.png" alt="Template before the reviewer's approval" class="full">
    <figcaption> Template before the reviewer's approval </figcaption>
    </figure>

### Approver perspective

1. An approver can check the list of message templates sent to be approved in **Settings > Approval Requests**.
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/servapproval6.png" alt="A list of approval requests" class="full">
    <figcaption> A list of approval requests </figcaption>
    </figure>

2. The approver goes to the **Templates** folder (it is available in the message type in the **Experience Hub** feature). The approver can either approve or unapprove the template. When the approver decides to unapprove the template, then they can write reasons for this decision. 
    <figure>
    <img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/servapproval5.png" alt="Template before the final approve" class="full">
    <figcaption> Template before the final approve</figcaption>
    </figure>


## Template statuses in library view
---
Any user that belongs to a workspace can see the template status in the template library.

- **Approved** - The template received final approval and can be used in communication.
- **Draft** - The template was rejected by the approver/reviewers.
- **Pending X/X** - This label appears on the template that waits for pre-approval or final approval.

<figure>
<img src="/api/docs/image/54176ad07f146575310749eba44b7c2f42c1b327/docs/settings/configuration/_gfx/service-approval-template-library.png" alt="Approval status of a template" class="full">
<figcaption> Approval status of a template </figcaption>
</figure>





