What you need
- An Octanist Professional plan or higher.
- The admin or owner role in your Octanist organization.
- A Pipedrive account with access to the pipeline you want to follow.
- Deals linked to a person with an email address or phone number. Octanist uses these to find the lead.
Table of Contents
- Connect Pipedrive
- Map your stages
- Set fallback values
- Name your integration
- What happens next
- Common problems
1. Connect Pipedrive
- In Octanist, go to Integrations and click Add integration.
- Find Pipedrive and click Set up.
- Octanist explains that the sign-in runs through Nango. Click Continue to Nango.
- Sign in with Pipedrive and give Octanist access.
Nango is the service Octanist uses to link your Pipedrive account. You sign in with Pipedrive itself, so neither Octanist nor Nango sees your password. Nango only keeps the access token, encrypted. Your deals and contact details go straight from Pipedrive to Octanist, not through Nango.
2. Map your stages
- Under Pipeline, select the pipeline to follow.
- For each stage, choose what it means for the lead:
- Don’t change the lead
- Qualified
- Won
- Lost
- Click Next Step.
3. Set fallback values
Enter the values Octanist uses when a deal has no usable amount:- Qualified Lead Fallback Value
- Won Lead Fallback Value
Octanist uses the deal amount from Pipedrive when it is above 0 and in your organization’s currency. A deal in another currency uses the fallback value.
4. Name your integration
- Enter an Integration Name, for example Pipedrive - Sales.
- Click Complete Setup.
5. What happens next
Checking for changes. Octanist checks Pipedrive about once an hour for deals in your pipeline that changed since you connected. Existing deals are not imported. A deal that was won or moved before you connected does not send a conversion, even if it is edited later. Finding the lead. For each changed deal, Octanist reads the email addresses and phone numbers of the deal’s person and looks for a matching lead. Only leads created before the deal moved can match. Octanist does not store the person’s details from Pipedrive. Updating the lead.- The lead gets the status of the stage, or won or lost from Pipedrive.
- Statuses only move forward: open to qualified, won or lost, and qualified to won or lost.
- Qualified and won leads get the deal amount, or your fallback value.
- When the amount of a qualified or won deal changes later, the lead’s value is updated too.
- Lost leads get the lost reason from Pipedrive.
- Qualified and won updates are sent to your connected ad platforms.
Check the status
Open Integrations to see the Pipedrive card. It shows:- Last sync: when Octanist last checked Pipedrive.
- Updated leads: deals that updated a lead.
- Without a lead: deals with no matching lead.
- Failed: deals that could not be applied.
6. Common problems
The integration is paused with “changes are waiting”. When more than 100 changes are waiting at once, Octanist pauses the integration. This protects your ad platforms from a wrong stage mapping or a bulk edit in Pipedrive. Open Integrations and click Apply changes to send them, or Discard changes to drop them. “Could not load your Pipedrive pipelines”. Reconnect Pipedrive, then try again. The integration shows “Reconnect required”. Pipedrive rejected the stored authorization. Go to Integrations and click Reconnect on the Pipedrive card. A deal changes but the lead does not update.- Check that the deal is in the pipeline you selected.
- Check that the stage is mapped, or that the deal is won or lost.
- Check that the deal has a person with an email or phone that matches the lead.