cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
1532
Views
8
Helpful
5
Comments
akalsey
Cisco Employee
Cisco Employee

Earlier this week, a new feature was added to Spark to tell you if a person is available or not. Based on your usage, we determine if you're actively using Spark and then in the client, help people understand if you're online or not by saying something like "Active 10 minutes ago" next to your name.

Now the Spark APIs have this same information available to you. The People API has two new fields, lastActivity and status that help your integration or bot determine if a Person is active or not. The lastActivity field gives you the date and time that Spark last saw the person doing something - writing a message or having a call, for example. The status field tells you if the person is "active" or "inactive".

These fields are read-only; there's no way to set a person's status through the API. Spark determines their status automatically, with no input needed from your side.

In the future, as Spark gets more presence options, the status field will gain those same options. So while you'll only see "active" and "inactive" today, you'll want to make sure your application doesn't break or behave oddly if you get a different status entirely.

5 Comments
sven.dens
Level 1
Level 1

Hi Adam,

I'm not seeing these fields. Has this change been committed to the API already?

Screenshot: https://s23.postimg.org/54kaqebhn/Screenshot_from_2016_12_21_09_43_41.png

Thanks!

psamanu
Cisco Employee
Cisco Employee

Hi Sven,

Can you try now?

Thanks.

sven.dens
Level 1
Level 1

Hi Pallavi,

I’ve just tried again, and indeed, now I see the fields.

Great addition to the Spark API, thanks!

Best regards,

Sven

aksmanch
Cisco Employee
Cisco Employee

Hi Adam,

Just wanted to understand how these two fields are working. I understand we cant change any of these manually.

If I stay logged in to Spark and dont write anything in my my space or to any person directly, would I be showing available to other watchers in spark?

how do you define an activity in spark? When it says "last active at X minute", what are the valid options that define an activity?

Thanks,

Akshay

akalsey
Cisco Employee
Cisco Employee

The Spark documentation describes behaviors and mechanisms that control status in the Spark platform.

Getting Started

Find answers to your questions by entering keywords or phrases in the Search bar above. New here? Use these resources to familiarize yourself with the community: