Current documentation suggests to use personal API tokens. This isn't ideal because for a few reasons: * messages will come as your own user, so it's hard to tell it's coming from hass * it's harder to manage if multiple people are using Slack and home * assistant, since you'd have to coordinate rolling of it It is possible to use Slack bot users already. Just make a new one from https://your-team.slack.com/apps/build/custom-integration, and use the token for that. You can even add an icon from the web frontend for home assistant. However, the message will appear as a bot without a name or icon. This pull requests fixes this by passing the as_user parameter, which uses the bot user's name and icon. One caveat is you need to invite the bot user into the room you want to post to. This probably was an issue before though. 🎩 to @jnewland who pointed me to this in his branch
58 lines
1.7 KiB
Python
58 lines
1.7 KiB
Python
"""
|
|
Slack platform for notify component.
|
|
|
|
For more details about this platform, please refer to the documentation at
|
|
https://home-assistant.io/components/notify.slack/
|
|
"""
|
|
import logging
|
|
|
|
from homeassistant.components.notify import DOMAIN, BaseNotificationService
|
|
from homeassistant.const import CONF_API_KEY
|
|
from homeassistant.helpers import validate_config
|
|
|
|
REQUIREMENTS = ['slacker==0.9.24']
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
# pylint: disable=unused-variable
|
|
def get_service(hass, config):
|
|
"""Get the Slack notification service."""
|
|
import slacker
|
|
|
|
if not validate_config({DOMAIN: config},
|
|
{DOMAIN: ['default_channel', CONF_API_KEY]},
|
|
_LOGGER):
|
|
return None
|
|
|
|
try:
|
|
return SlackNotificationService(
|
|
config['default_channel'],
|
|
config[CONF_API_KEY])
|
|
|
|
except slacker.Error:
|
|
_LOGGER.exception("Slack authentication failed")
|
|
return None
|
|
|
|
|
|
# pylint: disable=too-few-public-methods
|
|
class SlackNotificationService(BaseNotificationService):
|
|
"""Implement the notification service for Slack."""
|
|
|
|
def __init__(self, default_channel, api_token):
|
|
"""Initialize the service."""
|
|
from slacker import Slacker
|
|
self._default_channel = default_channel
|
|
self._api_token = api_token
|
|
self.slack = Slacker(self._api_token)
|
|
self.slack.auth.test()
|
|
|
|
def send_message(self, message="", **kwargs):
|
|
"""Send a message to a user."""
|
|
import slacker
|
|
|
|
channel = kwargs.get('target') or self._default_channel
|
|
try:
|
|
self.slack.chat.post_message(channel, message, as_user=True)
|
|
except slacker.Error:
|
|
_LOGGER.exception("Could not send slack notification")
|