Log Deepgram Call Summaries In Salesforce

Many companies use Salesforce as a source of truth for a wide variety of business activities and processes. You may be wondering how you can incorporate Deepgram to add richer information into Salesforce.

There are infinite variations on how companies customize their Salesforce instance; this blog post will demonstrate one example use case: summarizing sales calls using Deepgram, and logging the call summaries on a Salesforce opportunity and account.

Check out the GitHub repo that goes along with this post here.

Salesforce has its own world of concepts and relationships, and if you’re already in that world, then you’ll likely be familiar with all of the terms in this example. For readers newer to Salesforce, and to ensure a common understanding, here are some key concepts used throughout this example.

• Account: A profile record of a single customer, which could be either a company or an individual.
• Opportunity: A deal in progress with a specific account.
• Activity: A task, event, or calendar that happens in relation to progressing forward on an opportunity for an account. Employees perform activities in order to close a deal; this can involve calls, meetings, research, form submissions, page views, document signings, and more. In this example, we’ll be focused on call activities.
• Apex: Salesforce’s own programming language, offering an interface for CRUD operations (create, read, update, delete) on Salesforce objects, plus richer features that won’t be needed here.

Salesforce requires three pieces of information to use its API: your email, password, and an activity token.

Log into Salesforce as usual, noting the email and password you use to log in. Then follow their instructions to reset your security token, which will send you an email with your security token.

Now using your email, password, and security token, you will be able to use the Salesforce API. Those credentials will be filled in as static variables in the starter code.

EMAIL = "<YOUR_SALESFORCE_EMAIL>"
PASSWORD = "<YOUR_SALESFORCE_PASSWORD>"
SECURITY_TOKEN = "<YOUR_SALESFORCE_SECURITY_TOKEN>"

Ensure you have the Deepgram Python SDK installed via the command line:

pip install deepgram-sdk

This example provides a sample audio file, or you can provide a different URL to your own audio.

CALL_URL = "https://static.deepgram.com/examples/nasa-spacewalk-interview.wav"

You’ll also need to provide your own Deepgram API key.

DEEPGRAM_API_KEY = "<YOUR_DEEPGRAM_API_KEY>"

Finally, specify the name of an existing Salesforce account. This example assumes you have an account named “Deepgram.” You can create a new account for testing, or use an existing one.

ACCOUNT_NAME = "Deepgram"

With those pieces in place, you’ll summarize the call audio via a Deepgram API call with our summarization feature:

import json

from deepgram import Deepgram

deepgram_client = Deepgram(DEEPGRAM_API_KEY)

def summarize(deepgram_client, call_url):
    """Use Deepgram to summarize the call at the URL provided."""
    response = deepgram_client.transcription.sync_prerecorded({"url": call_url}, {"summarize": "v2"})
    summary = response["results"]["summary"]["short"]
    print("Generated call summary:", summary)
    return summary

The Deepgram API response JSON will contain the summary at the following path:

summary = response["results"]["summary"]["short"]

The simple-salesforce Python package is an open-source library which enables you to work with the Salesforce Apex API to run queries to create, read, update, and delete records. This example involves reading and updating account and opportunity records, and creating call activity records.

First, install the package on the command line:

pip install simple-salesforce

Then in Python, import the package, and create an authenticated client:

from simple_salesforce import Salesforce

salesforce_client = Salesforce(
    username=EMAIL, 
    password=PASSWORD,
    security_token=SECURITY_TOKEN
)

Query for the account ID given the name of the account the call was for:

query = f"SELECT Id FROM Account WHERE Name = '{account_name}'"
results = salesforce_client.query(query)["records"]
if results:
    account = results[0]
    account_id = account.get("Id", None)
    print(f"Account {account_name} has ID {account_id}")

Then use the account ID to get the latest opportunity for the account. If you prefer, you can modify the logic to select a different opportunity besides the latest one.

query = f"SELECT Name, Id FROM Opportunity WHERE AccountId = '{account_id}'"
results = salesforce_client.query(query)["records"]
if results:
    latest_opportunity = results[-1]
    opp_name = latest_opportunity.get("Name", None)
    opp_id = latest_opportunity.get("Id", None)
    print(f"Opportunity name '{opp_name}' has ID {opp_id}")

Now that you have the Salesforce IDs of the account and opportunity, you’re ready to log a new call event to the account and opportunity with the Deepgram call summary and today's date. You can customize this even further by setting your own date and call duration. 

This example makes the basic assumption that all calls are 60 minutes long, and just ended now. You can also customize the call’s subject to include any other information you prefer.

from datetime import datetime, timedelta

call_datetime = (datetime.utcnow() - timedelta(hours=1)).strftime("%Y-%m-%dT%H:%M:%S.%f%z")
response = salesforce_client.Event.create({
    "Subject": "Call",
    "Description": summary,
    "DurationInMinutes": 60,
    "ActivityDateTime": call_datetime,
    "WhatId": account_id,
    "WhatId": opp_id
})
print("Salesforce result:", response)
print("Wrote call event with ID:", response["id"])

Within the opportunity, in the Activity tab, you’ll see the call activity. When you toggle to display the activity’s complete information, you’ll see the Deepgram call summary in the description (shown in the screenshot below). You’ll similarly see the call in the activity log on the account.

When you click on the call, you can view its full details, including the opportunity it is related to. Note that you can enrich this record when you create it by making use of any other Salesforce-provided fields, such as the location, other relationships, or reminders. You can also create custom fields for any additional metadata you want to log.

This blog post demonstrated how you can use the Deepgram Python SDK and the simple-salesforce Python package for the Salesforce Apex API in order to summarize a sales call and log its summary to a Salesforce opportunity and account. This code also offers ample room for additional extension and customization depending on how your company is using Salesforce.

If you have any feedback on this example, please be sure to drop us a note on our GitHub discussion forum, Discord, or Twitter. 

Sign up for a Deepgram account and get $200 in Free Credit (up to 45,000 minutes), absolutely free. No credit card needed!

We encourage you to explore Deepgram by checking out the following resources:

1. Deepgram API Playground 
2. Deepgram Documentation
3. Deepgram Starter Apps

from datetime import datetime, timedelta
import json

from deepgram import Deepgram
from simple_salesforce import Salesforce

DEEPGRAM_API_KEY = "<YOUR_DEEPGRAM_API_KEY>"
EMAIL = "<YOUR_SALESFORCE_EMAIL>"
PASSWORD = "<YOUR_SALESFORCE_PASSWORD>"
SECURITY_TOKEN = "<YOUR_SALESFORCE_SECURITY_TOKEN>"

ACCOUNT_NAME = "Deepgram"
CALL_URL = "https://static.deepgram.com/examples/nasa-spacewalk-interview.wav"

def summarize(deepgram_client, call_url):
    """Use Deepgram to summarize the call at the URL provided."""
    response = deepgram_client.transcription.sync_prerecorded({"url": call_url}, {"summarize": "v2"})
    summary = response["results"]["summary"]["short"]
    print("Generated call summary:", summary)
    return summary

def update_salesforce(salesforce_client, account_name, summary):
    """Given an account name and call summary, add a Salesforce call event to the account and its latest opportunity."""

    # First, get account ID given account name
    query = f"SELECT Id FROM Account WHERE Name = '{account_name}'"
    results = salesforce_client.query(query)["records"]
    if results:
        account = results[0]
        account_id = account.get("Id", None)
        print(f"Account {account_name} has ID {account_id}")

        # Then get the latest opportunity on the account
        query = f"SELECT Name, Id FROM Opportunity WHERE AccountId = '{account_id}'"
        results = salesforce_client.query(query)["records"]
        if results:
            latest_opportunity = results[-1]
            opp_name = latest_opportunity.get("Name", None)
            opp_id = latest_opportunity.get("Id", None)
            print(f"Opportunity name '{opp_name}' has ID {opp_id}")

            # Finally, log a new call event to the account and opportunity, with the Deepgram call summary and today's date
            call_datetime = (datetime.utcnow() - timedelta(hours=1)).strftime("%Y-%m-%dT%H:%M:%S.%f%z")
            response = salesforce_client.Event.create({
                "Subject": "Call",
                "Description": summary,
                "DurationInMinutes": 60,
                "ActivityDateTime": call_datetime,
                "WhatId": account_id,
                "WhatId": opp_id
            })
            print("Salesforce result:", response)
            print("Wrote call event with ID:", response["id"])

def main():

    deepgram_client = Deepgram(DEEPGRAM_API_KEY)

    salesforce_client = Salesforce(
        username=EMAIL, 
        password=PASSWORD,
        security_token=SECURITY_TOKEN
    )

    summary = summarize(deepgram_client, CALL_URL)

    if summary:
        update_salesforce(salesforce_client, ACCOUNT_NAME, summary)

    print("Finished processing the call.")

if __name__ == "__main__":
    main()