Leads: De ID's van pijplijnen, fasen en leads vinden

De ID's van pijplijnen, fasen en leads zijn unieke codes die je gebruikt bij API's, webhooks, imports, externe integraties, auditlogboeken en andere technische processen. Werk je rechtstreeks in Voluit Suite? Dan hoef je deze ID's meestal niet in te vullen. Je kiest een pijplijn of fase dan op naam. De ID's worden pas belangrijk als een ander systeem of proces er specifiek om vraagt.

Wat zijn de ID's van pijplijnen, fasen en leads?

Elk ID verwijst naar een ander onderdeel van het leadbeheer in Voluit Suite. Als je weet waar een ID voor staat, kun je de juiste code gebruiken bij het instellen van integraties, het bijwerken van gegevens of het onderzoeken van wijzigingen aan een lead.

Pijplijn-ID (Pipeline ID): de unieke code van een specifieke pijplijn.
Fase-ID (Stage ID): de unieke code van een specifieke fase binnen een pijplijn.
Lead-ID (Opportunity ID): de unieke code van één afzonderlijke lead.

Een ID is iets anders dan de naam die je in Voluit Suite ziet. Een pijplijn kan bijvoorbeeld Verkooppijplijn heten. Het pijplijn-ID is de unieke systeemcode die bij die pijplijn hoort.

Hetzelfde geldt voor een fase met de naam Gekwalificeerde mogelijke klant. Het fase-ID verwijst naar die specifieke fase binnen de pijplijn.

Waarom zijn deze ID's nuttig?

Met een uniek ID kan een systeem naar de juiste pijplijn, fase of lead verwijzen. Dat blijft werken als je een naam wijzigt of als dezelfde naam op meerdere plekken voorkomt. Dit is vooral belangrijk als Voluit Suite gegevens uitwisselt met een ander systeem.

De juiste gegevens herkennen: verwijs naar de juiste pijplijn, fase of lead als een technisch proces een exacte code nodig heeft.
API's en integraties gebruiken: geef de vereiste ID's mee aan ondersteunde API-eindpunten, webhookprocessen of externe integraties.
Bestaande leads bijwerken: geef aan welke lead een ondersteunde update moet aanpassen.
Problemen onderzoeken: gebruik ID's om specifieke pijplijnen of leads terug te vinden in ondersteunde auditlogboeken en diagnostische processen.
Betrouwbaar automatiseren: voorkom onduidelijkheid als een extern systeem naar een specifiek gegeven in Voluit Suite moet verwijzen.

Wanneer heb je een pijplijn-ID, fase-ID of lead-ID nodig?

Voor de meeste dagelijkse handelingen in Voluit Suite hoef je geen ID's handmatig in te vullen. Controleer daarom eerst of je het onderdeel op naam kunt selecteren.

Je kunt een ID nodig hebben bij:

API's van Voluit Suite
Webhooks
Zapier of een andere ondersteunde externe integratie
Het importeren of bijwerken van leads
Auditlogboeken (Audit Logs)
Technische processen die je zelf inricht
Omleidingen of links naar een specifieke lead

Maak je een lead aan in Voluit Suite? Dan selecteer je meestal de Pijplijn (Pipeline) en de Pijplijnfase (Pipeline Stage) uit de beschikbare opties.

Dat geldt ook voor standaardacties in workflows. Bij de actie Lead aanmaken (Create Opportunity) selecteer je de pijplijn en pijplijnfase rechtstreeks. Je hoeft daarvoor geen fase-ID in te vullen.

Let op: niet elke integratie of API-aanvraag heeft alle drie de ID's nodig. Controleer altijd wat het specifieke eindpunt, de webhook, de import of de integratie vereist.

Hoe hangen pijplijnen, fasen en leads samen?

Pijplijnen, fasen en leads vormen een hiërarchie: een pijplijn bevat fasen, en elke fase bevat leads. Die structuur helpt je bepalen naar welk onderdeel een extern proces verwijst.

Bijvoorbeeld:

Pijplijn: Verkooppijplijn
Fase: Gekwalificeerde mogelijke klant
Lead: Nieuwe website voor ACME

Het pijplijn-ID verwijst naar Verkooppijplijn.

Het fase-ID verwijst naar de fase Gekwalificeerde mogelijke klant binnen die pijplijn.

Het lead-ID verwijst naar de afzonderlijke lead Nieuwe website voor ACME.

Verwar een fase-ID niet met de naam van de fase. De naam is het label dat je ziet. Het ID is de systeemcode die bij die fase hoort.

Zo vind je pijplijn-ID's en fase-ID's

Pijplijn-ID's en fase-ID's zijn vooral relevant als een technisch proces om deze systeemcodes vraagt. Voor het dagelijkse beheer van pijplijnen en leads heb je ze niet nodig: in de standaardinterface selecteer je de onderdelen op naam.

Heb je een pijplijn-ID of fase-ID nodig en haal je die niet op via een ondersteunde API of integratie? Dan kun je leads exporteren om deze gegevens op te halen.

Zo exporteer je leads:

Ga naar Leads (Opportunities).
Klik rechtsboven op het menu met de drie puntjes.
Selecteer Leads exporteren (Export Opportunities).
Wacht tot Voluit Suite de export heeft verwerkt.
Open het geëxporteerde bestand en bekijk de beschikbare gegevens over leads, pijplijnen en fasen die je voor jouw proces nodig hebt.

Gebruik je een API, webhook, Zapier of een andere externe integratie? Dan kan het bijbehorende pijplijn-ID of fase-ID ook via dat proces worden teruggegeven of vereist zijn. Volg de actuele documentatie van dat eindpunt of die integratie. Ga niet uit van een vaste ID-indeling.

Let op: de oudere werkwijze via Zapier is niet de enige manier om deze ID's op te halen. De stappen kunnen verschillen per integratie of API-bewerking.

Pijplijn-ID

Een pijplijn-ID is de unieke code van één pijplijn in je Voluit Suite-account. Je gebruikt deze code als een technisch proces naar de pijplijn zelf moet verwijzen, in plaats van alleen de naam te tonen of te selecteren.

Je kunt pijplijn-ID's gebruiken voor:

API-aanvragen voor een specifieke pijplijn
Externe integraties die een pijplijn moeten herkennen
Webhooks of gegevensverwerking
Ondersteunde toepassingen voor auditlogboeken of probleemonderzoek

Voor het dagelijkse beheer van pijplijnen heb je geen pijplijn-ID nodig. Ga in Voluit Suite naar Leads → Pijplijnen (Pipelines). Daar kun je pijplijnen aanmaken en hernoemen, en fasen beheren of in een andere volgorde zetten zonder ID's te gebruiken.

Fase-ID

Een fase-ID is de unieke code van een specifieke fase binnen een pijplijn. Je gebruikt die vooral als een API of externe integratie de systeemcode nodig heeft in plaats van de zichtbare naam.

Een pijplijn kan bijvoorbeeld deze fasen bevatten:

Nieuwe mogelijke klant
Gekwalificeerd
Voorstel verstuurd
Afgesloten

Elke fase heeft een eigen systeemcode.

Werk je rechtstreeks in Voluit Suite? Dan heb je meestal geen fase-ID nodig. Bij het aanmaken van leads en het instellen van workflows kies je een fase op naam.

Als je handmatig een lead aanmaakt, selecteer je bijvoorbeeld:

De pijplijn
De pijplijnfase
De overige gegevens van de lead

Ook bij de workflowactie Lead aanmaken selecteer je de pijplijn en pijplijnfase rechtstreeks.

Gebruik een fase-ID alleen als het externe proces dat je instelt daar expliciet om vraagt.

Zo vind je een lead-ID

Een lead-ID verwijst naar één afzonderlijke lead. Anders dan pijplijn-ID's en fase-ID's is dit ID rechtstreeks zichtbaar bij de lead. Je gebruikt het onder andere voor auditlogboeken, directe links, imports en technische integraties.

Zo vind je het lead-ID:

Ga naar Leads.
Open de lead die je wilt bekijken.
Zoek linksonder in de geopende lead naar het lead-ID.
Klik op het lead-ID als je de bijbehorende activiteit in de auditlogboeken wilt openen.

Het lead-ID vinden in de URL

Je kunt het lead-ID ook uit de URL van de lead halen.

Open de betreffende lead.
Bekijk de URL in je browser.
De code aan het einde van de URL is het ID van die lead.

Deze methode is ook bruikbaar als je een directe link naar een lead wilt delen met een andere gebruiker die toegang heeft tot je Voluit Suite-account.

Waarvoor gebruik je een lead-ID?

Een lead-ID is nuttig als een proces één specifieke lead moet herkennen, in plaats van een hele pijplijn of fase. Dat is vooral belangrijk bij het bijwerken van bestaande leads of het onderzoeken van problemen.

Veelvoorkomende toepassingen zijn:

Auditlogboeken: bekijk de activiteit rond een specifieke lead.
Directe links: open of deel een link naar één lead.
Imports: geef aan welke bestaande lead je wilt bijwerken.
API-aanvragen: verwijs naar een specifieke lead als het eindpunt dat vereist.
Externe integraties: koppel gegevens uit een extern systeem aan de juiste lead in Voluit Suite.

Wil je via een import een bestaande lead bijwerken? Neem dan het lead-ID op. Zonder dit ID kan Voluit Suite een nieuwe lead aanmaken in plaats van de bestaande lead bij te werken.

ID's gebruiken bij het importeren van leads

Je kunt een lead-ID gebruiken om bestaande leads via een CSV-import bij te werken. Met het juiste ID kan Voluit Suite elke geïmporteerde rij koppelen aan de lead die je wilt aanpassen.

Voor het importeren van leads zijn onder andere deze velden vereist:

Contact-ID (Contact ID)
Leadnaam (Opportunity Name)
Pijplijn

Werk je een bestaande lead bij? Neem dan ook het lead-ID op in de gegevens die je aan de importvelden koppelt.

ID's gebruiken met API's en externe integraties

API's en externe integraties kunnen ID's gebruiken om naar gegevens in Voluit Suite te verwijzen, zonder afhankelijk te zijn van zichtbare namen. Welk ID je nodig hebt, hangt af van de bewerking.

Bijvoorbeeld:

Een aanvraag voor een pijplijn kan een pijplijn-ID vereisen.
Een aanvraag voor een fase kan een fase-ID vereisen.
Een update van een lead kan een lead-ID vereisen.

Controleer altijd de actuele documentatie van het specifieke API-eindpunt of de integratie voordat je een ID invult. De actuele API-documentatie vind je in de Marketplace API-documentatie. Baseer nieuwe integraties niet op de werking van verouderde API's.

Let op: een pijplijn-ID, fase-ID en lead-ID zijn niet onderling uitwisselbaar. Met het verkeerde ID kan een integratie of API-aanvraag mislukken of naar het verkeerde onderdeel verwijzen.

Zo vind en gebruik je het juiste ID

Bepaal eerst naar welk onderdeel in Voluit Suite het externe proces moet verwijzen. Zo voorkom je onnodig zoekwerk en zorg je dat updates bij de juiste gegevens terechtkomen.

Bepaal of het proces verwijst naar een pijplijn, een fase of een afzonderlijke lead.
Controleer of je een naam kunt gebruiken in plaats van een ID.
Heb je een pijplijn-ID of fase-ID nodig? Haal die op via de ondersteunde export, API, webhook of integratie die je gebruikt.
Heb je een lead-ID nodig? Open de lead en haal het ID uit de leadgegevens of de URL.
Controleer in de actuele documentatie van de integratie of API of je het juiste type ID gebruikt.
Test het proces voordat je het op grotere schaal toepast.

Veelgestelde vragen

V: Heb ik een pijplijn-ID nodig om een lead aan te maken in Voluit Suite?

Antwoord: Nee. Als je een lead aanmaakt in Voluit Suite, selecteer je de pijplijn uit de beschikbare opties.

V: Heb ik een fase-ID nodig om een lead aan te maken?

Antwoord: Niet als je een lead op de standaardmanier aanmaakt in Voluit Suite. Je selecteert de pijplijnfase op naam. Een fase-ID is meestal alleen nodig als een API of externe integratie er specifiek om vraagt.

V: Is een fase-ID hetzelfde als de naam van een fase?

Antwoord: Nee. De fasenaam is het label dat je in Voluit Suite ziet. Het fase-ID is de unieke systeemcode die bij die fase hoort.

V: Kunnen twee pijplijnen fasen met vergelijkbare namen hebben?

Antwoord: Ja. Fasen horen bij een pijplijn. Gebruik bij een externe integratie daarom het ID dat de configuratie vereist. Ga er niet van uit dat een fasenaam altijd naar de juiste fase verwijst.

V: Waar vind ik een lead-ID?

Antwoord: Open de lead en zoek het lead-ID in de leadgegevens. Je kunt het ID ook vinden aan het einde van de URL van de lead.

V: Waarom heb ik een lead-ID nodig bij een import?

Antwoord: Als je een bestaande lead via een import bijwerkt, helpt het lead-ID Voluit Suite bepalen welke lead moet worden aangepast. Zo voorkom je dat er een nieuwe lead wordt aangemaakt.

V: Hebben alle API's en integraties pijplijn-ID's, fase-ID's en lead-ID's nodig?

Antwoord: Nee. De vereisten verschillen per eindpunt of integratie. Bij sommige bewerkingen kun je een naam selecteren of invullen. Andere bewerkingen vereisen unieke ID's.

V: Kan ik de naam van een pijplijn of fase gebruiken in plaats van een ID?

Antwoord: In Voluit Suite en in standaardworkflows kun je meestal rechtstreeks een naam selecteren. Gebruik bij API's en externe integraties de veldindeling die de bijbehorende documentatie voorschrijft.