Bygger du en Upsales-app för en chattleverantör, en webinarvärd eller någon annan tjänst som konverterar leads? Skapa din egen typ av marknadshändelse och låt dina användare hantera sina leads på ett ställe.
Egna marknadshändelser är enkla att skapa med Upsales API och har stöd för marknadspoäng på kontaktperson och företag, notiser till användare och anpassade vyer för händelsedetaljer.
Skicka bara en POST till
https://integration.upsales.com/api/v2/events?token=<apiKey>med en json-body som innehåller följande egenskaper:
score (number) *required*
Händelsens marknadspoäng. Om poängen är 0 döljs händelsen i många vyer.
date (string)
Datum och tid för händelsen i formatet YYYY-MM-DD HH:mm:ss. Om inget anges används aktuell tid.
client (number)
ID för det företag som händelsen hör till. Utan företag skickas ingen notis.
contact (number)
ID för den kontaktperson (om någon) som händelsen hör till.
entityType (string) *required*
Måste vara MarketingCustom.
integrationId (number)
ID för den Upsales-app som skapar händelserna (om någon).
externalId (string)
- Högst 36 tecken
Lägg till ett id från ett externt system på händelsen. Praktiskt både när du söker efter händelser och när användaren vill se fler detaljer om händelsen.
subType (string)
Kort beskrivning av typen av marknadshändelse. Oftast något i stil med Webinar.
value (string)
Ett värde som kompletterar marknadshändelsens subType. Läs mer om hur du använder subType och value längre ned.
notify (true/false)
Sätt till true för att meddela de kontoansvariga om händelsen. Obs! Om poängen är 0 skickas ingen notis, även om notify är true.
notifyUserIds (Array)
Om notify är true kan du hoppa över att meddela de kontoansvariga och i stället ange alla mottagares användar-id här.
Exempel med curl:
curl -H 'Content-Type: application/json' -d '{"score":10,"client":1,"entityType":"MarketingCustom","subType":"MyMarketing","value":"Awesome marketing event!", "notify": true}' "https://integration.upsales.com/api/v2/events?token=<apiKey>"
Så använder du subType och value
När din marknadshändelse har subType och value visas händelsen oftast för användaren med en måltavleikon och en text som den här:
contact hade marknadshändelse subType value
Vi har dock byggt särskild tolkning för några utvalda subTypes som du kan använda för att ge din händelse en egen visning!
subType Chat (pratbubbleikon)
contact chattade på value
subType Video (play-ikon)
contact såg video value
subType Event (biljettikon)
contact deltog i event value
subType Twitter (Twitter-ikon)
contact twittrade value