slackhq / slack-api-docs

API Docs for Slack.com
https://api.slack.com/
426 stars 85 forks source link

Docs say RTM supports message formatting, but apparently do not #32

Closed DanTup closed 9 years ago

DanTup commented 9 years ago

In the RTM docs, it says:

The RTM API only supports posting simple messages formatted using our default message formatting mode.

The first thing on the linked page is for URLs. However, I was unable to make this work and got the response:

Sorry, the RTM API doesn't support formatted links. Try the chat.postMessage API method instead.

This should be clarified in the docs. I spent some time debugging before realising it wasn't my code, and I suspect others might do the same.

(Or, even better, add support for it and make the API match the docs)

clintkelly commented 9 years ago

:+1: I just spent about an hour trying to get links to work before I found this issue.

awalla commented 9 years ago

Thanks for bringing this up, and sorry for the hassle! This is on our list to improve and clarify in our documentation. If there's anything else we can help with, we'll be keeping an eye on issues here, but for a generally quicker response, we're also at feedback@slack.com. Thanks again!

zackify commented 8 years ago

Why did this get closed. I also just wasted an hour.

dcsan commented 8 years ago

looks like @awalla is a bot, other issues are closed without them actually be fixing and the same message added.

mccreath commented 8 years ago

@zackify @dcsan As awalla mentioned (who is one of our support agents, and not a bot), we keep an eye on things here, but we don't actively do support here. Your best bet for questions about the API is emailing feedback@slack.com.

The most up-to-date version of the docs are at https://api.slack.com/. This repo is updated regularly from that. We will get the formatting info for the RTM API looked at tomorrow. Thanks for bringing it up.

zackify commented 8 years ago

The bot doesn't seem to get it's text formatted when sending replies. I'm using the new botkit. I'm really liking it! :) On Wed, Dec 16, 2015 at 22:46 David McCreath notifications@github.com wrote:

@zackify https://github.com/zackify @dcsan https://github.com/dcsan As awalla mentioned (who is one of our support agents, and not a bot), we keep an eye on things here, but we don't actively do support here. Your best bet for questions about the API is emailing feedback@slack.com.

The most up-to-date version of the docs are at https://api.slack.com/. This repo is updated regularly from that. We will get the formatting info for the RTM API looked at tomorrow. Thanks for bringing it up.

— Reply to this email directly or view it on GitHub https://github.com/slackhq/slack-api-docs/issues/32#issuecomment-165329472 .