Skip to main content

Salesforce integration: send a Scribeless mailer manually from a Lead or Contact

Send a one-off Scribeless mailer from a Salesforce Lead or Contact record.

Use the Scribeless manual send action when a sales or customer success user should choose a campaign before sending one handwritten mailer from Salesforce.

The action currently supports Lead and Contact records. Account-level sending is not included in this version because Scribeless recipients are person-level.

Before you start

  • The Scribeless Salesforce package is installed.

  • The Scribeless_API Named Credential is configured.

  • Your user has the packaged Scribeless Callout Access permission set and access to the Scribeless External Credential principal.

  • Your Scribeless account has a campaign in an eligible status, such as Ready, Pending, or Paused.

  • The Lead or Contact has enough postal data to create a recipient.

For Leads, the required Salesforce fields are First Name, Street, and Country. For Contacts, the required fields are First Name, Mailing Street, and Mailing Country.

Add the action to Lead and Contact pages

If users cannot see Send Scribeless Mailer, a Salesforce admin needs to add the Lightning Web Component action to the relevant page layout.

  1. Go to Setup > Object Manager.

  2. Open Lead or Contact.

  3. Open Buttons, Links, and Actions.

  4. Confirm there is a Lightning Web Component action using the scribelessMailer component.

  5. Open Page Layouts and edit the active layout.

  6. Add Send Scribeless Mailer to Salesforce Mobile and Lightning Experience Actions.

  7. Save the layout.

Send from a Lead

Open the Lead record. In the top-right action area, select the more actions dropdown and choose Send Scribeless Mailer.

Salesforce Lead action menu with Send Scribeless Mailer

The modal opens with the Salesforce recipient summary and a Scribeless campaign dropdown.

Send Scribeless Mailer modal with recipient summary and campaign dropdown

Choose a Scribeless campaign

Open the Scribeless campaign dropdown and choose the campaign you want to send to. The dropdown is loaded from the Scribeless account connected by the API key and labels each campaign with its status.

Completed or unavailable campaigns, such as shipped or deleted campaigns, are not shown for manual recipient creation.

Scribeless campaign dropdown showing the Salesforce Demo campaign

Fill campaign-specific fields

After you choose a campaign, Salesforce checks whether the Scribeless campaign has template variables. Each returned variable appears as a required input.

Obvious values such as first name, last name, company, title, and address fields can be prefilled from Salesforce. A booking-link or QR-code field can also be prefilled from the logged-in Salesforce user's Scribeless booking link, if your admin has configured that user field.

Campaign-specific fields for the Salesforce Demo campaign

Add a personalized message

If the Scribeless template includes a custom message field, the sender can add the note text directly before sending. For example, a short follow-up can be used after a sales meeting.

Short personalized message entered in the Send Scribeless Mailer modal

Longer messages can also be entered when the campaign template supports them. Review the generated preview after sending so the sender can confirm the output.

Longer personalized message entered in the Send Scribeless Mailer modal

Send the mailer

When the recipient details, campaign, and campaign fields are ready, select Send mailer. Salesforce creates the recipient in Scribeless and shows the result.

The result can include the recipient ID, recipient status, an inline preview after it is generated, and buttons to open the preview or open Scribeless.

Manual send success state with generated preview for a short message
Manual send success state with generated preview for a longer message

Send from a Contact

The Contact workflow is the same as the Lead workflow. Open the Contact record, select the top-right action dropdown, then choose Send Scribeless Mailer.

Salesforce Contact action menu with Send Scribeless Mailer

Contacts use the Contact mailing address fields. If the Contact has an Account address but no Contact mailing address, complete the Contact mailing address before sending.

Missing field errors

If the record does not have enough information, Salesforce blocks the send before calling Scribeless. The modal shows the missing Salesforce fields and includes Edit record in Salesforce so the user can update the source record.

Manual send validation when required Salesforce fields are missing

This keeps Salesforce as the source of truth for recipient and mailing address data.

Troubleshooting

  • If the action is missing, ask a Salesforce admin to add it to the Lead or Contact layout.

  • If the campaign dropdown is empty, check the Scribeless API key and confirm the connected account has an eligible campaign.

  • If the modal shows a Salesforce credential, callout, Named Credential, or External Credential error, ask an admin to confirm your user has access to the External Credential principal. This access is granted in a customer-owned permission set, separate from the packaged Scribeless permission set.

  • If the send button is disabled, choose a campaign and complete all required campaign fields.

  • If the preview does not display after a successful send, ask a Salesforce admin to check the CSP Trusted Site setup for the Scribeless preview image host.

Did this answer your question?