Question

API - Join events and alerts information

I

Hey there!

I am trying to combine information from knowledge alerts and the eventsĀ (a.k.a analytics)Ā endpoint, however, I am unsure how to do this. So far, my best attempt has been joining both information using the field card_idĀ (both knowledge_alerts and events provide it) and filtering the events with type = ā€˜alert-readā€™. However, this is not ideal since a given card_id could be related to > 1 knowledge alert, so my question isā€¦Ā Is there any way to know which event is related to which knowledge_alert? It would be nice to have an `alert_id` field under the events endpoint.

Thank you in advance!

IƱigo

10 replies

Joe Duffy
Rank
Userlevel 3

Hi @idevi97!

We currently do not expose anĀ alertIdĀ in our analytics endpoint - this is something I can take back to our Product team to see if we can include when the type=ā€™alert-readā€™.

We do, however, provide the ability toĀ exportĀ user details for a knowledge alert given anĀ alertId. If you make a POST call toĀ https://api.getguru.com/api/v1/alerts/{alertId}/exportĀ you will receive an email with a list of users, and whether or not they have read the knowledge alert. Of course, to make that call youā€™ll need the alertId, which you can get by making aĀ GETĀ call to this endpoint:Ā https://api.getguru.com/api/v1/alerts.

I hope this is able to get you closer to what youā€™re looking for!

Thanks!

Joe

I

Hey Joe!

Thanks for the quick reply!Ā :grinning:

It does get me closer to what I need I think. However, I was wondering if there is some way to export this information for ALL knowledge alerts, instead of specifying one by one. Something similar to includingĀ view=ALL_SENT under theĀ https://api.getguru.com/api/v1/alertsĀ endpoint.

Thanks for your help!

IƱigo

I

Also, this would be great!!Ā šŸ‘‡šŸ¤©

this is something I can take back to our Product team to see if we can include when theĀ type=ā€™alert-readā€™

Ā 

If you find time to do so, can you inform me with their answer? And if possible, an approximate time to be available? It would be sooo helpful for us (and probably for other guru API users) if itĀ gets implemented šŸ™Œ

Joe Duffy
Rank
Userlevel 3

Hi @IƱigo De VicenteĀ 

Thanks so much for the feedback!

However, I was wondering if there is some way to export this information for ALL knowledge alerts, instead of specifying one by one. Something similar to includingĀ view=ALL_SENT under theĀ https://api.getguru.com/api/v1/alertsĀ endpoint.

Unfortunately at this time, the /v1/alerts/{alertId}/export endpoint doesnā€™t have the ability to export data for more than one alertId.

Our product team is aware of the enhancement request to the analytics endpoint to include alertId where type = ā€˜alert-readā€™ - however, we donā€™t have a timeline for the enhancement at this time. The Product team may be reaching out to you directly over the next month or so for more information and to further understand your specific use case.

Sorry we donā€™t have an immediate solution for this one!

Let me know if you have any other questions in the meantime.

Thanks!

Joe

I

Perfect!

Thanks @Joe DuffyĀ for your help!Ā :grinning:

I

When the time comes, pleaseĀ reach out to me underĀ i.devicente@stuart.comĀ to discuss theĀ implementation.

Thanks again for all your effort and help

Joe Duffy
Rank
Userlevel 3

Will do @IƱigo De Vicente! Thanks again for your feedback!

A

Hello @Joe Duffy, I saw Guru included a bunch of new features and endpoints to the APIā€¦Ā Is there any news about the issue discussed in this topic? I had a look and it doesnā€™t seem like we can yet understand who read which alert through the alerts or analytics (i.e. events) endpointsā€¦

Thanks in advance for the help!

Joe Duffy
Rank
Userlevel 3

Hi @Akane Sudre!

Thanks for following up here. At this time, we still recommend using the endpoint below to receive an export containing data around who has read a specific Knowledge Alert:

POST https://api.getguru.com/api/v1/alerts/{alertId}/export

Iā€™ll be sure to reply here if we create an endpoint that allows you to see this data directly in the response from the API call.

Thanks!

A

Thanks for the fast response @Joe DuffyĀ !

Unfortunately, an export does not really work for us because we would like to automate this process. ThisĀ endpointĀ entails getting a report for every knowledge alert is sent, which we would need of aĀ second automation to download/extract the report from the email (not really best-practice)

I would appreciate it if you replied in here once it gets implemented directly from the API!

Thanks again :))

Reply


Terms & ConditionsCookie settings