Routing naar een verkoopproces

Doel

Een saleslead die via de API binnenkomt, wordt een Aanvraag met een gekoppelde Deal. Dit artikel legt uit in welk verkoopproces en in welke fase die Deal begint, en hoe je dat instelt.

Je hoeft in je API-aanvraag geen verkoopproces of fase mee te sturen. Plenno bepaalt dat zelf.

Hoe Plenno de bestemming bepaalt

API-aanvraag
   ↓
Aanvraag
   ↓
saleslead? → gekoppelde Deal
   ↓
bestemming bepalen
   ↓
verkoopproces + fase

Plenno kiest de bestemming van de Deal in deze volgorde:

1. De livesleutel heeft een eigen bestemming. Dan gebruikt Plenno die.
2. Anders: de algemene instelling "Waar starten nieuwe deals?". Dan gebruikt Plenno het verkoopproces en de fase die je daar hebt gekozen.
3. Staat daar ook niets, of is de keuze niet meer bruikbaar? Dan gebruikt Plenno het standaardverkoopproces van je bedrijf en daarin de eerste beschikbare open fase.

Is er uiteindelijk geen enkele bruikbare open fase, dan kan Plenno de Deal niet maken. Een saleslead wordt dan geweigerd met 500 internal_error en niet aangemaakt; zie Als het niet lukt hieronder.

De Aanvraag zelf staat altijd bij Aanvragen, met een eigen aanvraagfase. Alleen de Deal volgt de bestemming hierboven.

Algemeen instellen: "Waar starten nieuwe deals?"

Deze instelling geldt voor je hele bedrijf: voor handmatig ingevoerde aanvragen, het websiteaanvragen, n8n-koppelingen en de API (tenzij een livesleutel een eigen bestemming heeft). Een eigenaar of beheerder stelt hem in.

1. Ga naar Instellingen → Waar starten nieuwe deals?.
2. Kies het Verkoopproces, bijvoorbeeld "Sales".
3. Kies de Fase, bijvoorbeeld "Nieuwe lead".
4. Klik op Opslaan.

Wil je terug naar het standaardverkoopproces, kies dan Standaard gebruiken en sla op.

Wordt het gekozen verkoopproces of de gekozen fase later gearchiveerd, dan toont Plenno daar een melding bij en gebruikt het tijdelijk het standaardverkoopproces. Kies dan opnieuw.

Per API-sleutel instellen

Wil je dat Deals van één bepaalde sleutel ergens anders beginnen, bijvoorbeeld in een eigen verkoopproces voor website-aanvragen? Geef die livesleutel dan een eigen bestemming.

1. Ga naar Instellingen → Integraties → API-sleutels (websiteformulieren).
2. Zoek de livesleutel, bijvoorbeeld "Website formulier". Bij Bestemming staat nu Standaardroute.
3. Klik op Instellen (of Wijzigen als er al een eigen bestemming is).
4. Kies in het venster Bestemming van API-deals het Verkoopproces en daarna de Fase, bijvoorbeeld "Sales" → "Nieuwe lead".
5. Klik op Opslaan.

Bij de sleutel staat daarna bijvoorbeeld Bestemming: Sales → Nieuwe lead.

Dit kan alleen voor een actieve livesleutel, en alleen door een eigenaar: API-sleutels staan onder Integraties, en daar heeft een beheerder geen toegang toe. Een medewerker met extra toegang API en integraties ziet de bestemming, maar kan hem niet wijzigen. De fase moet een open fase zijn: een Deal begint nooit in "gewonnen" of "verloren".

Terug naar de algemene standaard

Kies in dat venster bij Verkoopproces voor Algemene standaard gebruiken en klik op Opslaan. Dat betekent dat de sleutel geen eigen afwijkende route meer heeft: nieuwe Deals van deze sleutel volgen weer de algemene instelling "Waar starten nieuwe deals?".

Is de eigen bestemming van een sleutel niet meer actief (bijvoorbeeld omdat het verkoopproces is gearchiveerd), dan staat er bij de sleutel een melding en gebruikt Plenno de standaardroute.

Wat geldt voor welk type aanvraag

Zie Een aanvraag aanmaken en bijwerken voor type, en Live- en testsleutels voor het verschil tussen live en test.

Voorbeeld

Je bedrijf heeft twee verkoopprocessen: "Installatie" en "Sales". Je stelt in:

• Waar starten nieuwe deals? → Installatie → Intake
• Livesleutel "Website formulier" → Bestemming → Sales → Nieuwe lead

Een aanvraag met de sleutel "Website formulier" levert dan een Deal op in Sales → Nieuwe lead. Een aanvraag via een andere livesleutel, of handmatig ingevoerd, levert een Deal op in Installatie → Intake.

De API-aanvraag is in beide gevallen hetzelfde:

{
  "name": "Jan Voorbeeld",
  "email": "jan@example.com",
  "external_id": "website-lead-1001",
  "type": "lead"
}

Een Deal hernoemen

Een automatisch aangemaakte Deal krijgt de naam van de aanvrager. Je kunt hem later in Plenno hernoemen met Naam wijzigen bij de Deal.

Als het niet lukt

• Zie je geen knop Instellen bij een sleutel? Dan is de sleutel een testsleutel of ingetrokken, of je bent geen eigenaar.
• Begint een Deal niet waar je verwacht? Controleer eerst of de aanvraag een livesleutel gebruikt en type lead is (of ontbreekt). Controleer daarna of de sleutel een eigen bestemming heeft; die gaat vóór de algemene instelling.
• Krijg je 500 internal_error bij een saleslead en heeft je bedrijf geen actief verkoopproces met een open fase? Maak of heractiveer er een. De aanvraag is dan niet aangemaakt; je kunt hem met dezelfde external_id opnieuw sturen.

Vervolg

Lees Verantwoordelijke medewerker meegeven.