Using the User Events API (early access)

Have more questions? Submit a request

15 Comments

  • Thomas Verschoren

    If the Proporties contain an URL value, is there a way to display a link?

     

    E,g. we have now linked Freshbooks Estimate creations to user tickets.

    Would be useful to embed a link back to the freshbooks item so we can quickly see the invoice.

    I tried doing an HTML escaped href= but that just added text.

    1
  • Charles Nadeau

    Hi Thomas, you might also try cross-posting your question in the Events API forum:

    https://develop.zendesk.com/hc/en-us/community/topics/360000030527-Events-API-beta-

     

    0
  • Robin Tang

    Hi Thomas,

    I'm assuming you are referring to the Customer Context timeline rendering links, as if you were just using the API you would be able to render it in whichever way you would like it.

     

    Adding a link that is clickable during the hover state is certainly a possibility. I will bring this up with our front end engineer!

    0
  • Thomas Verschoren

    An example will make it clearer:

     

    I use the following json to create an Event

    {
    "user_id": "12345",
    "type": "newinvoice",
    "source": "freshbooks",
    "description": "New Invoice 2018/01",
    "created_at": "2018-12-13T17:51:00Z",
    "properties": {
    "amount": "98.74",
    "link": "http://www.domain.com"
    }
    }

    But having the link at least clickable, or replacable with

    {title: "invoice 123", url:"www.domain.com"} would be neat.

    0
  • Sander Verhaeven

    Hi,

     

    Would it be possible to show the source of an event in interface? It would be nice if we could set an icon as well.

    {
    "user_id": "11962081749",
    "source": "Akti",
    "type": "Planned_Intervention",
    "created_at": "2018-11-05T22:26:00Z",
    "description": "Plan Intervention"
    "icon":"http://url.to/icon.png"
    }

    would result in 

    1
  • Billy Kong

    Hi I am testing this api by using user emails to save an event. On zendesk support user ticket, I cannot see where the event is being displayed. Any help here? The get request returns me a json with the event I saved but I cannot see it on zendesk.

    Thanks

    edit: i see the interactions tab but it is not updating with saved events

    0
  • Bryan Flynn

    @Thomas, @Sander, @Billy -- Since it looks like you're talking about the new Interaction feature in the agent UI and how it uses event data, I suggest posting issues at Viewing customer context in a ticket. The product managers are monitoring that space more closely and answering feedback regarding this new agent UI feature there.

    For questions related directly to the Events API, then posting on the community area's Events API (beta) page is best.

    0
  • Marlene Hirose

    I'm attempting to use: GET /api/cdp/events?user_id={id} using our credentials and such

    And all I get is this: 

    {"id":1020,"reason":"Profile not found"}

    What am I doing wrong?

    0
  • Bryan Flynn

    Hi Marlene -- if you're following the above example:

    curl 'https://{{subdomain}}.zendesk.com/api/cdp/events?user_id=345&event_type=checkout' \
      -H "Accept: application/json" \
      -v -u {email_address}:{password}

    ... and assuming you're authenticated in correctly and your account has been given permission for this feature (it's an "early access program"/beta feature, so not everyone has access to it), then I'd say you probably need to open a ticket with support@zendesk.com. There are probably things against your account that need to be checked beyond what can be done or shared in a public post.

    0
  • Marlene Hirose

    thank you, Bryan. I shall do that

    0
  • Thomas Verschoren

    Can you delete an event too?

    0
  • Bryan Flynn

    Hi Thomas,

    Events are immutable, so they cannot be deleted. The design intent is that you want to create a trail of events that cannot change. If you need to "delete" something, another event would be created to "roll back" that change.

    This is a new feature that's still evolving, so if you have use-cases that you'd like to share, please do!

    0
  • Thomas Verschoren

    One scenario would be where the external system mismatched a user due to conflicting account info. (E.g. email and phone but phone is applicable to two users).

    Other scenario would be an error in the external system. Someone changed a status from shipped to delivered by accident resulting in a wrong status update.

    Or, someone could make a typo in an event.. ;-)

    0
  • Bryan Flynn

    Thanks for taking the time to share Thomas. I'm sure this will be an ongoing topic as this feature is used more and more.

    0
  • Thomas Verschoren

    When I try to create an Event via the url: '/api/cdp/track', I can get an update in the timeline by pushing the following code:

    var task = {
    user_id: $("#requester-id").val(),
    type: 'Quick Note',
    source: 'My-App',
    description: 'Test',
    created_at: '',
    properties: {
    Note: 'Some Note',
    Agent: 'Thomas'
    }
    };

    It creates the event TEST correctly in the screenshot below, but also adds a weird profile_attribute_update.

    Where does this come from and can I disable it?

     

    0

Please sign in to leave a comment.

Powered by Zendesk