Skip to content
  • There are no suggestions because the search field is empty.

Call sentiment analysis and BigChange logging

In this guide, we'll build a workflow in Build Concierge that:

  • Automatically analyzes completed calls;

  • Detects customer sentiment;

  • Logs the results as a Contact Note in BigChange; and

  • Flags notes where manager escalation is required.

1. Introduction to example use case

Greenshield Pest Control are a company that provides pest control services to domestic customers across the South of England.

2. Current process

Every day, their team handles calls from customers, reporting pest issues, booking visits, or asking for follow-up support.

Current process

3. Manual note entry

Currently, when a call ends, the team manually reviews the call notes and logs a summary as a Note in BigChange so there's a record against the Contact.

If a customer complains or is frustrated, the Note must also be manually flagged for a manager to review it.

This process takes time and relies on the team remembering to flag important conversations.

Manual note entry

4. Build Concierge workflow intro

By building this workflow once in Build Concierge, every completed call is automatically analyzed by AI, logged against the correct Contact in BigChange, and tagged if escalation is required.]

Let's see how to build it!

Build Concierge workflow intro

5. Log in to your account

Log into your Build Concierge account.

Log in to your account

6. Open Workflow Builder

Click on the Workflow Builder icon.

Open Workflow Builder

7. Create a new workflow

Click Create new workflow.

Create a new workflow

8. Name the workflow

Give the workflow a name like "Call sentiment and BigChange logging."

Name the workflow

9. Add description (optional)

Add an optional description to give more context.

Add description (optional)

10. Create workflow

Click Create.

Create workflow

11. Add Call Completed Starting action

Add a Call Completed Starting action to the Workflow Editor.

Add Call Completed Starting action

12. No configuration required

This Starting action requires no configuration.

It will automatically output:

  • Call transcription;

  • AI summary;

  • Contact name; and

  • Direction of the call.

No configuration required

13. 📚 Learn more

Learn more about the Call Completed node in the guide entitled Call Completed Starting action.

14. Add AI Prompt node

Drag and drop an AI Prompt node into the Workflow Editor.

This step of the workflow will analyze the call transcript and return structured outputs related to sentiment and any required escalation.

Add AI Prompt node

15. Connect the nodes

Connect it to the Call Completed starting action.

Connect the nodes

16. Click node to configure

Click on the node to open the Properties panel.

Click node to configure

17. Add your prompt

Paste in your sentiment and escalation prompt.

Make sure to include the Call transcript variable as part of the input.

You can copy and paste the example prompt below and tweak it to fit your own needs:

Analyze the following call transcript. Return ONLY valid JSON.

Transcript:


Instructions:

Determine overall customer sentiment: positive, neutral, or negative.

Provide a sentiment score from -1.0 (very negative) to +1.0 (very positive).

Decide if escalation to a manager is required: true/false.
Escalate if there is any: threat to cancel/complaint, abusive language, legal action, safety risk, repeated unresolved issue, refund demand, high frustration.

Provide a short reason and 1–3 supporting quotes.

Add your prompt

18. Example prompt summary

The example prompt asks that the AI:

  • Determine the customer sentiment as positive, neutral or negative.

  • Provides a sentiment score from -1 (very negative) to +1 (very positive).

  • Determes if escalation to a manager is required: True or False; and

  • If yes, provides the reasons for escalation.

Example prompt summary

19. Adjust temperature

Set the temperature to 0 for consistent results.

Adjust temperature

20. Click +Add

In the Output section, click + Add and define the following outputs.

Click +Add

21. Escalate to manager

Escalate to manager

22. Sentiment score

Sentiment score

23. Escalation reason

Escalation reason

24. Save configuration

Click Save to save the configuration.

Now, every completed call will be analyzed automatically.

Save configuration

25. 📚 Learn more

You can learn more about AI Prompt nodes in the guide entitled AI Prompt action.

26. Add Search Contact in BigChange node

Next, add a Search Contact in BigChange node.

This will identify the right Contact in BigChange to log the call against.

Add Search Contact in BigChange node

27. Connect the nodes

Connect it to the Complete branch of the AI prompt node.

Connect the nodes

28. Click to configure node

Click on the node to begin the configuration.

Click to configure node

29. Map Contact Name variable into Search Term field

Map the Contact Name of the caller, which was output as a variable by the Call Completed Starting action into the Search Term field.

This is the term which will be used to search for the contact in BigChange.

Map Contact Name variable into Search Term field

30. Click Save

Press Save.

If a single contact match is found using the Search Term, the workflow should continue to the next step to create a Contact Note in BigChange.

Click Save

31. 📚 Learn more

To learn more about the Search Contact in BigChange node, read the article Search Contact in BigChange action.

32. Add a Create a Contact Note in BigChange node

Add a Create Contact Note in BigChange node into the Workflow Editor.

Add a Create a Contact Note in BigChange node

33. Connect the nodes

Connect the Create Contact Note in BigChange node to the Found One branch of the Search for a Contact in BigChange node.

This ensures a note is only created if exactly one Contact is matched.

Connect the nodes

34. Insert Note Owner ID

Open the Properties panel.

Configure the Note Owner ID field, which is mandatory.

This value can be taken from your BigChange account and inserted manually.

Insert Note Owner ID

35. Select the Entity Type

Select Contact in the Entity Type field.

Select the Entity Type

36. Add Entity ID

In the Entity ID field, add the Contact ID variable that was returned by the Search Contact in BigChange node.

Add Entity ID

37. Insert Note Type ID

In the Note Type ID field, insert the Note Type ID manually, which you can find in your BigChange account.

Insert Note Type ID

38. Configure the Subject field

In the Subject field, insert a subject for all new Contact Notes.

For example, the subject could be "Call Record" followed by the Call Direction variable, so you can quickly see if the call was inbound or outbound.

Configure the Subject field

39. Configure Note Text field

Insert the Call Summary variable into the Note Text field.

This adds the AI-generated call summary into the main body of each Contact Note.

Configure Note Text field

40. Save Configuration

You can leave the remaining optional fields blank.

Then, press Save.

Now, every call will automatically create a structured Contact Note in BigChange.

Save Configuration

41. 📚 Learn more

Learn more about the Create Contact Note in BigChange node by reading the guide entitled Create Contact Note in BigChange action.

42. Add Extract Text node

The next step is to analyze whether escalation to a manager is required based on the content of the call.

To do this, first add an Extract Text node.

Add Extract Text node

43. Connect nodes and open Properties panel

Connect the nodes and click the Extract Text node to open the Properties panel.

Connect nodes and open Properties panel

44. Configure Text to Extract from field

In the Text to Extract from field, map the Escalatetomanager output from the AI prompt node.

Configure Text to Extract from field

45. Click +Add

Under the Regular Expressions section, click + Add to define the data point to be extracted.

Click +Add

46. Enter Output name

Add the name of the output, which will be Escalate.

Enter Output name

47. Enter Regex Pattern

Then add the regular expression, (True).

This will look for the word 'True' when checking the Escalatetomanager output.

Enter Regex Pattern

48. Choose Data Type

Keep the Data Type as Text.

Choose Data Type

49. Save configuration

Click Save.

Now, if the Escalatetomanager output is True, meaning escalation is required, the workflow will continue to the next and final step, which will add a flag to the note.

Save configuration

50. 📚 Learn more

To learn more about the Extract Text node, read the guide entitled Extract Text action.

51. Add External Action node

Add an External Action node to the Workflow Editor.

Add External Action node

52. Connect nodes and open Properties panel

Connect it to the previous node and open the Properties panel.

Connect nodes and open Properties panel

53. Configure URL with SetTag endpoint

Add the BigChange SetTag endpoint in the URL field, which you can find on the BigChange developers page.

Configure URL with SetTag endpoint

54. Include Note ID variable

Map the Note ID variable into the relevant point of the endpoint, after EntityId=.

Include Note ID variable

55. Add Escalation Reason variable

And the EscalationReason variable after Comment= in the endpoint.

Add Escalation Reason variable

56. Select Request Method

Set the Request Method to GET.

Select Request Method

57. Navigate to Headers tab

Navigate to the Headers tab.

Navigate to Headers tab

58. Introduction to Headers

We'll add the BigChange Authorization and Key as headers. These should already be setup as secrets in your account settings.

59. 📚 Learn more

You can learn more about how to do this in the guide entitled Secrets Management.

60. Add a HTTP Header

Click on the + Add button.

Add a HTTP Header

61. Configure Enter Name field

Enter Authorization under the Enter Name field.

Configure Enter Name field

62. ⚠️ Note

Spelling and capitalization matter here! Make sure you use the US-English spelling with a 'Z' for Authorization.

63. Enter the value

In the Enter value field:

  • type Basic then add a space

  • Click +Add a variable

  • Choose the relevant BigChange authorization secret variable from the dropdown.

Enter the value

64. Add another HTTP Header

Click + Add again.

Add another HTTP Header

65. Name the Header

Name this header — Key in the Enter Name field.

In the Enter value field, map the BigChange key variable by:

  • Clicking + Add a variable

  • Selecting the BigChange key secret from the dropdown.

Name the Header

66. Save Configuration

Click Save.

Save Configuration

67. 📚 Learn more

To learn more about the External Action node, read the guide entitled External Action action.

68. Conclusion

Now, whenever a call is completed by Greenshield's team, it will be analyzed for sentiment, logged as a note in BigChange and automatically flagged if escalation is needed, with no manual review required.

Conclusion
Please add a description