Problem Statement: Reimbursement request for bills is the most common and frequently used task inside the organizations. People often need to upload/provide the invoices to the concerned team for approval/processing in the specific application.
Opportunity: Capturing the critical information for approval from the invoice without asking the user to input the required fields. Submitting the processing request with the original invoice in the Service management tool with the bot.
Approach: Configure a skill in the Bot to reimburse the bill. The skill initially asks the user to upload the invoice. The attachment which is the uploaded invoice is now sent to OCR REST API to collect all the required information like invoice id, amount, dates, and all other relevant information. A confirmation request is sent to the user on the identified information from the invoice document. Upon approval from the user, the reimbursement request is sent with the invoice details and attachment of the invoice in the create service request.
The following are the key steps in creating the ticket in ISM by a Support Agent for an end-user:
Define Attribute
Create an attribute Attachment to get the invoice/bill from the end-user on the channel.
On Skill Builder--> Attribute tab, click on Create Attribute.
Add attribute details such as Name and Data type.
Set the prompt message to be displayed to the end-user, like “Please attach your bill here“
Click Save.
Follow the above steps and create the below attributes:
‘InvoiceID’ to store the unique ID number in the bill.
‘Date’ to store the numbers in the date format in the bill.
‘Amount’ to store the total billed amount in the invoice.
‘Bill Details’ to store the values of InvoiceID, Date, and Amount in a single variable.
Create an Integration
Define Integration to OCR with the “OCR REST API - OCR recognition” operation.
On the tenant menu, click on Integration.
Create an Application with the integration type as REST.
Add an instance to the OCR environment.
Configure the ‘OCR REST API - OCR recognition’ Operation.
Fetch the access token received as a response from the web service and save it in a local attribute Invoice Details.
Follow the above steps and create the following integrations:
Select operation ‘Get bill information’ to get the values from the bill details for the user from OCR REST API. Fetch the bill details received as a response from the web service and save it in a local attribute bill information.
Select operation ‘Create Service Request.' Override the Integration and pass the value in the “bill information” form field to the operation. For more details on creating an integration, refer to Integration
Set the success message to be displayed on successful form submission. Use the local attribute TicketNumber to show the logged ticket number to theuser.For example; “Created ticket @{local.ticketIdentifier} in ISM for the submitted invoice“
Build a Skill
On Skill Builder--> Create Skill tab, enter Skill details such as Skill Name, Category, Description, and KPI Metrics
Under Invocation type, add User Phrases such as ‘Fetch Invoice details,’ ‘Update with my bill details’
Under Conversation flow,
Add the Integration operation OCR REST API - OCR recognition to get the Invoice Details associated with the attachment.
Add the attribute Bill Details.
Add the Integration operation Get bill information to get the details associated with the bill.
Add Information Message to display the values associated with the local attribute bill information. For example, “The values are Invoice ID:123456 Date:11/12/2020 Amount: 500”
Add a Ruleset to let the user decide if the obtained values are correct. Configure the following rules.
If bill information displayed to the user is as expected, continue with the next steps.
If bill information displayed to the user is improper, prompt the user that the details are incorrect and exit the skill.
Add the Integration operation Create Service Request to send the Bill Details to ISM in the local attribute bill information.
Add Information Message to display ticket submission confirmation message to the end-user. For example, “Creating a ticket in ISM with Invoice details is completed for the user”.
Click Save to finish building the skill.
The next step is to add permission to the skill. Click on Permission and the Users or Groups who should be able to execute the Skill.
Run Build and Publish to make the skill available in the Virtual Agent.
Once the skill is Published, Go to the Test Widget to test the skill. Click on Debug Logs and execute the skill to view the runtime Skill execution logs.
Your action has now been created successfully, and Support Agents can execute the action on the Agent chat console.
Additional Resources
Visit the below Wiki Documentation for more information on:
Creating an Attribute on Create Global Attributes
Configure a 3rd party Web service integration on REST Integrations
Creating and Managing Skills is at Create Skills
Using local attribute in skills on Use Variables in Skills
Publishing Skill on Build and Publish
Understanding Conversation logs on Conversation History.
Using Transformation Functions: Random is at Transformation Function Random
Provide permissions to users or groups at Permission
Defining Rulesets on Using Rule Sets
Test your Skill on Test your Bot
Debugging skill on Debug Skills