I am actually not sure this is documented, as we honestly didn't expect anyone to integrate so deeply. We have some documentation we could make public. The syntax is inspired by Markdown, and is f.ex. as follows:
So it is an @-sign followed by the name of the user in brackets and the reference to the user in parentheses.
Just put this in the status or comment text, and the rest is automatic.
Hope this makes sense.