Skip to main content

SalesForce integration

Coverage

This is a plugin for pretalx that serves to send speaker and proposal information to SalesForce.

Information is sent every eight hours or on manual sync, and is mapped as follows:

  • Users and their speaker profiles are sent as contacts:
    • Contact.pretalx_LegacyID__c is set to the pretalx user ID

    • Contact.FirstName is set to the first part of a user’s name, separated by whitespace.

    • Contact.LastName is set to any remaining part of a user’s name.

    • Contact.Email is set to the user’s email address.

    • Contact.Biography__c is set to the user’s biography.

    • Contact.pretalx_Profile_Picture__c is set to the user’s profile picture URL.

  • Submission objects are set synced to the custom Session object:
    • pretalx_LegacyID__c is set to the submission’s pretalx ID.

    • Name is set to the submission’s title.

    • Session_Title__c is the submission’s full title, as Name is truncated to 80 characters.

    • Track__c is set to the submission’s track (by name, not by ID).

    • Submission_Format__c is set to the submission’s type (by name, not by ID).

    • Status__c is set to the submission’s status.

    • Abstract__c is set to the submission’s abstract plus the submission’s description, separated by two newlines and then stripped of whitespace.

    • Pretalx_Record__c is set to the submission’s public URL.

  • The mapping between Contacts and Sessions is synced to the custom Contact_Session__c object:
    • Contact__c is set to the Salesforce Contact.

    • Session__c is set to the Salesforce Session.

Development setup

  1. Make sure that you have a working pretalx development setup.

  2. Clone this repository, eg to local/pretalx-salesforce.

  3. Activate the virtual environment you use for pretalx development.

  4. Run pip install -e . within this directory to register this application with pretalx’s plugin registry.

  5. Restart your local pretalx server. This plugin should show up in the plugin list shown on startup in the console. You can now use the plugin from this repository for your events by enabling it in the ‘plugins’ tab in the settings.

Development commands

This plugin uses just as a task runner and uv for dependency management. Run just with no arguments to list every available command. The most useful ones are:

just fmt

Auto-format and lint the code.

just test

Run the full test suite with pytest.

Installing pretalx

The tests need pretalx installed in the environment. just test handles this for you: if pretalx cannot be imported, it installs the latest version from git before running the test suite.

If you already have a development version of pretalx around (for example if you want to test your changes against a specific commit or branch of pretalx), you can also install pretalx up front yourself:

just install-pretalx-local /path/to/pretalx

Install pretalx from a local checkout as an editable install.

just install-pretalx

Install the latest pretalx from git (runs before tests if no pretalx is installed).

License

Copyright 2024 Tobias Kunze

Released under the terms of the Apache License 2.0

Metadata

Release files for pretalx-salesforce 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pretalx-salesforce 0.4.0
File Size Uploaded
pretalx_salesforce-0.4.0.tar.gz 73.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pretalx-salesforce 0.4.0
File Interpreter ABI Platform
pretalx_salesforce-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 127.6 kB

Release files / pretalx_salesforce-0.4.0.tar.gz

Download URL pretalx_salesforce-0.4.0.tar.gz
Size 73.8 kB
Tags Source
SHA-256 checksum
How to use checksums
e5b2a0fc0aa610e19042f2699393cbf00bb1dc65e6950f98b10b2d9ca20193d4
BLAKE2b-256 checksum
How to use checksums
4f77bf1520a6699c0a733acb2f17cccb840943aa6ba4e68332e8969aa0667c63
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / pretalx_salesforce-0.4.0-py3-none-any.whl

Download URL pretalx_salesforce-0.4.0-py3-none-any.whl
Size 53.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f3e39ee7bc141afcf731cc9d56e0f40b3cdeef5502ba2ed49099a193708a4a2c
BLAKE2b-256 checksum
How to use checksums
e9725eca9071874f5b89d1971713fd04ce44bbb3b5492c4548ea956ce4645280
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page