Talk object
Load TalkJS and generate conversation IDs.
This page covers the Classic SDK. For new projects, use the Components SDK.
The Talk object provides utility functions to help use TalkJS.
Talk.ready is a Promise; any function passed to its then method is called when
the TalkJS script has loaded. Put all TalkJS-related code in blocks like these. You
can call then from multiple places if you want. For example:
Talk.ready.then(function() {
// Use TalkJS after it has fully loaded
})Talk.oneOnOneId(me, other): stringUse this helper method to predictably compute a Conversation ID based on participants' ids in the given conversation. Use this method if you want to simply create a conversation between two users, not related to a particular product, order or transaction.
The order of the parameters does not matter. For example, Talk.oneOnOneId("a", "b") yields the same result as Talk.oneOnOneId("b", "a").
This method takes the following steps:
- Take two ids of users and put them in an array
- Sort them lexicographically
- JSON encode them
- Hash the result using SHA1, return the first 20 characters
In pseudocode, this is what this function does:
var sorted = [me.id, other.id].sort()
var encoded = JSON.encode(sorted)
var hash = sha1(encoded) // as lowercase hex
return truncate(hash, 20)A TalkJS User or a string containing the user ID.
Another TalkJS User or a string containing the user ID.