Create Direct Call Template

1. Log into Nimbus Admin. Head to Configuration > Direct Call Templates
2. Create a new Template. In our example we call it “Agent Token Usage”
3. This template will consist of 2 actions:
   1. Grab an Employee Information via Microsoft Graph, which will use the Agent Token for delegated permissions to read out data fields from Microsoft Entra ID.
   2. Open PostmanEcho, which proofs that upon a call the information was successfully retrieved. 
      💡 You can substitute this action with a CRM call or other API call of your choosing. 

Configure Your Template Actions

✅ After creation of your template it's time to configure it's actions, starting with the actual Graph Request.

1. Add as first action to get the EmployeeID from Graph. 💡 Our Action naming is just an example.
   Graph Request Action
   ✅ The Trigger ID will be needed in the next step. Make sure to copy it for later.
2. In the "General" tab, make sure your URL is configured as follows
   https://graph.microsoft.com/v1.0/me?$Select=employeeId
   💡 "employeeId" is your example used in Microsoft Entra ID available through Graph API. You can use any field of your choice. 
3. In the "Authorization" tab, ensure that "Use Agent Token" is selected as Authentication method.
   "Agent Token" setting
4. In the "Response" Tab , ensure "Wait for Response" is enabled with a recommended timeout of 5s.
5. Close the action with "Save and Apply"

Check for Successful Data Retrieval

✅ In this step we add a 2nd action to test the data retrieval from Graph. We use Postman in this example to make an API request. You need to substitute this with your own CRM requests.

1. Still within your Call Template, create a 2nd action right below the first Graph retrieval.
2. In the "General" settings, specifiy the URL field as follows: 
   Setting up an API request using the previous Action Trigger ID and Azure AD “employeeId”
   ✅ Use your Trigger ID copied from the previous step (Template Action)
   https://postman-echolcom/get?someId={{YourTriggerID.body.employeeId}}
   💡 Note that the Field "employeeId" needs to matches directly with the one from Microsoft Entra ID for the user (or with any other field of your choice).
   
   Lastly, save and close your new call template.

Assign and Test the Template

✅ Finally you need to assign the template to a user that has the Assistant app installed and licensed.

1. Head to the User Administration > YourUser > Assistant Tab
2. Assign your newly created template
   Assignment of the template to a user
3. Now, directly call that user while having your web-development tools open in bowser. You can verify the request and results directly in there:
   Verifying the Graph API request

4. second action then gets executed (GET request to postman-echo) which contains the actual values

Verifying the GET request and IDs

In the request URL you can see the retrieved employeeId is sent accordingly

The headers specified in the 2nd action are filled accordingly too (x-userid, randomguid and callerid)