Para utilizar o Telegram no Home Assistant você não precisa instalar nenhum componente ou add-on, porém você precisará seguir os passos abaixo.
Essa integração necessita da internet para utiliza-la.
Você pode ver mais detalhes na página oficial do home assistant:
Primeiro você precisa abrir o seu telegram na plataforma que achar melhor (android, web, iphone…)
Com o telegram aberto, procurem o bot chamado BotFather como na imagem abaixo:
Criando um bot:
Feito isso, será necessário criar um novo bot para você. Então clique na opção /newbot .
1) Irá vir uma pergunta questionando qual o nome do seu bot. Você digita um nome apropriado para você.
Exemplos: Watson, Home Assistant, Morpheus, MyBot, etc…
2) A segunda pergunta é o nome de usuário. Perceba que deverá acompanhar a palavra “ bot ” no final do username.
Exemplos: watsom_bot, homeassistant_bot, morpheus_bot, mybot, etc…
Logo em seguida você receberá as informações de finalizado junto com o token para acesso via API.
Copie esse código e salve em um documento, bloco de notas para ser utilizado mais para frente.
Após criar seu bot, você precisará procurar seu bot nos seus contatos do Telegram. Você irá procurar pelo mesmo nome que você deu no “username”. E clicar para falar com ele. Irá abrir a tela de conversa com um botão START, clique nesse botão.
3) Será necessário resgastar o “chat_id”. Para você obter essa informação você precisará copíar o token gerado anterior, copiar a url a seguinte URL https://api.telegram.org/bot YOUR_API_TOKEN /getUpdates e trocar a parte “YOUR_API_TOKEN” pelo token que você gerou do seu bot criado.
Exemplo: http://api.telegram.org/bot578745016:AAFvUqqEPEjeBgW40IhwO_TZgGJS3QitdXQ/getUpdates
E colocar no seu navegador (chrome, firefox, ie, safari…). O resultado se tudo ocorrer bem deve ser esse:
4) Agora volte ao telegram, e no seu bot digite qualquer coisa para ele. Exemplo: Olá meu bot.
Volte para a url da api com seu token e atualize a página. Irá mostrar o valor do chat_id. Copie conforme a imagem abaixo e guarde num documento ou bloco de notas.
esse é o chat_id!
Se não conseguir dessa forma, mande alguma mensagem para o @RawDataBot que ele vai retornar um código que vai aparecer o seu chat_id.
Configurando o telegram no configuration.yaml:
Coloque as duas configurações!
Configurando o bot no configuration.yaml:
telegram_bot:
- platform: polling
api_key: YOUR_API_KEY #aqui você coloca o token gerado no bot
allowed_chat_ids:
- CHAT_ID_1 #aqui você coloca o chat_id que você pegou após conversar com o bot.
- CHAT_ID_2
- CHAT_ID_3
Configurando o configuration.yaml para notificações:
notify:
- platform: telegram
name: SEU NOME #nome que achar melhor
chat_id: CHAT_ID #aqui você coloca o chat_id que você pegou após conversar com o bot.
Video:
Exemplo de automação:
Para notificar quando o seu HA é iniciado:
automation:
# alias = Nome da sua automação
- alias: 'Teste de telegram'
# trigger = São os gatilhos que definem quando sua automação irá ser executada
trigger:
platform: homeassistant
event: start
# action = São as ações que sua automação irá executar ao iniciar
action:
service: notify.NOTIFIER_NAME # aqui você coloca o nome que você definiu no notify no campo "name" na configuração anterior.
data:
title: 'Olá Douglas'
message: "O seu home assistant foi iniciado."
Com isso configurado você poderá agora usar o serviço do Telegram em suas automações, testes, scripts, etc.
Recomendo esses tutoriais aqui utilizando o Node-red: