Important

The actions in this repository are used in aSalesforce Dreamforce 25 Heroku Mini Hack. They're here to help people who did the minihack challenge, and have access to the minihack org and its objects, apps, and agents. So, these examples won't work outside the minihack. Also, the steps below are just for reference and won't work unless you use them in an org that has the correct objects already deployed. If you want to explore Heroku in the context of Agentforce please check out thistutorial and also further sampleshere.

Requirements

Local Development and Testing

python -m venv venvsource venv/bin/activatepip install -r requirements.txt

sf org login web --alias my-orguvicorn app.main:app --host 127.0.0.1 --port 8080

heroku applink:functions:exec -a YOUR_HEROKU_APP_NAME -u my-org -p'{"customerId": "0035g00000XyZbHAZ","vehicleId": "a04Hs00002EMj9PIAT","maxInterestRate": 0,"downPayment": 1000,"years": 3}' --"/api/calculateFinanceAgreement"

{"recommendedFinanceOffer":{"finalCarPrice":41800.0,"adjustedInterestRate":3.5,"monthlyPayment":...}}

heroku applink:functions:exec -a YOUR_HEROKU_APP_NAME -u my-org -p'{"flightId": "a02Hs00001D2QtLIAV"}' --"/api/calculateCarbonFootprint"

{"flight":{"flightNumber":"...","departureAirport":"SFO","arrivalAirport":"LAX",...}}

Deploying and Testing from Apex and Flow

3.11

heroku creategit push heroku main

heroku addons:create heroku-integrationheroku buildpacks:add heroku/pythonheroku buildpacks:add https://github.com/heroku/heroku-buildpack-heroku-integration-service-meshheroku salesforce:connect my-org --store-as-run-as-user# You will need to regenerate an api-docs.yaml for the python app if you want to re-import# heroku salesforce:import api-docs.yaml --org-name my-org --client-name ActionsService

sf org assign permset --name ActionsService -o my-org

git push heroku mainheroku logs --tail

Invoking from Apex

ExternalService.ActionsServiceservice=newExternalService.ActionsService();ExternalService.ActionsService.calculateFinanceAgreement_Requestrequest=newExternalService.ActionsService.calculateFinanceAgreement_Request();ExternalService.ActionsService_FinanceCalculationRequestbody=newExternalService.ActionsService_FinanceCalculationRequest();request.body=body;request.body.vehicleId='a04Hs00002EMj9PIAT';System.debug('Final Car Price:'+service.calculateFinanceAgreement(request).Code200.recommendedFinanceOffer.finalCarPrice);