Activiteiten

Activiteiten zijn de afzonderlijke eventrecords die SalesDash bijhoudt — een gevoerd gesprek, een gesloten deal, een gehouden vergadering, geregistreerde advertentiekosten. Ze zijn het ruwe materiaal waarop metrics worden berekend.

Typen activiteiten

SalesDash heeft vijf activiteitstypen:

Agent-activiteiten zijn events die door een specifieke agent worden uitgevoerd — het meest voorkomende type. Ze bevatten een typelabel (bijv. gesprek, vergadering of een aangepast type dat door de provider is gedefinieerd), een moment, een waarde en een contactsleutel. Voorbeelden: een geplande afspraak, een ingediend formulier, een bereikte pipelinefase.

Gesprekken zijn telefoongesprekken met een duur, een resultaat en contactinformatie. Gebruikt wanneer de provider een powerdialer of telefoonplatform is. Gesprekken hebben extra velden die zijn geoptimaliseerd voor telefoondata.

Sales zijn gesloten deals met een propositie, contractwaarde en optionele provisieberekening. Gebruikt voor omzetgebaseerde metrics. Sales hebben extra velden voor financiële data.

Periodes zijn tijdsintervallen met een begin- en eindtijdstip. Gebruikt om lopende statussen weer te geven, zoals momenteel openstaande deals of momenteel actieve klanten.

Anonieme activiteiten zijn events die niet aan een specifieke agent zijn toegeschreven. Gebruikt voor data die bestaat op project- of campagneniveau in plaats van individueel niveau — advertentiekosten zijn een typisch voorbeeld. Anonieme activiteiten kunnen nog steeds bijdragen aan metrics, maar zijn niet gekoppeld aan de prestaties van een agent.

Wat een agent activiteit vastlegt

Elke agent activiteit legt het volgende vast:

• Type — wat voor soort event het was (bijv. gesprek, vergadering of een aangepast type gedefinieerd door de provider)
• Agent — wie het heeft uitgevoerd (opgelost vanuit de externe identiteit op het moment van synchronisatie)
• Moment — wanneer het plaatsvond
• Waarde — een numerieke maatstaf die bij het event hoort (bijv. dealwaarde in euro's)
• Provider — uit welk extern systeem het afkomstig is
• Contactsleutel — een identificator voor de klant of het contact (gebruikt voor contactgebaseerde metrics zoals het aantal unieke benaderde leads)
• Extern ID — het ID van het oorspronkelijke record in het externe systeem; gebruikt om de activiteit te matchen bij volgende synchronisaties zodat het kan worden bijgewerkt in plaats van gedupliceerd

Waar activiteiten vandaan komen

Activiteiten worden aangemaakt door providers — via een gepland synchronisatieproces of een webhook. Elke activiteit bevat een external_id en een provider_id die het bronrecord identificeren. Wanneer dezelfde combinatie bij een volgende synchronisatie wordt aangetroffen, werkt SalesDash de bestaande activiteit bij in plaats van een duplicaat aan te maken.

external_id hoeft niet één-op-één overeen te komen met een record in het externe systeem. Een provider kan een samengesteld ID opbouwen door meerdere componenten samen te voegen met | als scheidingsteken — dit is de standaardconventie die in SalesDash-integraties wordt gebruikt, inclusief adapters zoals Make en Zapier.

Twee veelvoorkomende gevallen waarbij dit relevant is:

• Records met meerdere fases — als een deal vijf pipelinefases doorloopt en elke overgang een afzonderlijke activiteit moet worden, gebruik dan <deal_id> | <fase_id> zodat elke overgang een eigen uniek ID krijgt.
• Gemengde recordtypen van één provider — als dezelfde provider zowel deals als introducties importeert, kunnen hun numerieke ID's botsen (deal #5 en introductie #5 zijn verschillende records). Door het recordtype als component op te nemen — deal | 5 en introductie | 5 — blijven ze onderscheidbaar.

Hoe activiteiten metrics aandrijven

Een metricdefinitie bepaalt wat er geaggregeerd wordt — het brontype, de functie (aantal, som, gemiddelde, etc.), eventuele filters — en hoe het resultaat wordt weergegeven (opmaak, eenheid, formulering). Het bepaalt niet voor wie er geaggregeerd wordt, over welke periode, of met welke extra filters.

Die context wordt geleverd door wat de metric gebruikt. Een competitie gebruikt de metric per agent over de tijdsduur van de competitie. Een teamdoel gebruikt hem opgeteld over het hele team. Een dashboardwidget gebruikt hem over een instelbaar datumbereik. Dezelfde metricdefinitie kan dit alles tegelijkertijd aandrijven, waarbij elk element een ander resultaat oplevert omdat de omringende context verschilt.

Omdat agent activiteiten via externe identiteiten aan agents worden gekoppeld, dragen alleen activiteiten van gekoppelde identiteiten bij aan resultaten op agentniveau. Activiteiten van ongekoppelde externe identiteiten worden opgeslagen maar niet meegeteld.