E se o seu Home Assistant pudesse realizar uma ligação para você? Avisando que alguém está em sua residência, ou que um vazamento foi identificado?
É isso mesmo que vamos falar nesse artigo, como realizar ligações para qualquer número de telefone do Brasil, utilizando o Home Assistant e o Twilio.
Configurando
Para você poder utilizar desse recurso, você irá precisar criar uma conta no site Twilio. Nessa conta você vai criar/obter um número do Brasil ( número de telefone ), a qual vai ser utilizado para realizar as ligações para os números que você desejar.
Twilio – Criando uma conta
- Acesse o site https://www.twilio.com e crie uma conta com seu e-mail;
- Após criar a conta, você precisa confirmar através de seu e-mail;
- Após confirmar seu e-mail, você precisa adicionar um número de celular a qual irá receber um código de confirmação. Por isso, adicione um número válido;
- Em seguida, o site Twilio irá realizar alguns questionamento para lhe conhecer melhor. As respostas são indiferentes, ou seja, pode selecionar qualquer resposta.
- Após responder as questões, sua conta estará criada, e agora vamos configurar um novo número dentro do Twilio para que você possa receber as ligações realizadas pelo Home Assistant e Twilio.
Twilio – Obtendo um número do Brasil
- Com a conta criada e autenticada, clique no menu ao lado esquerdo, na opção “All Products & Services”;
- Em seguida, selecione a opção “Programmable Voice”;
- Selecione a opção “Numbers”;
- Clique no botão “Get Number”;
- Você receberá um novo número. Esse número será o que irá realizar as ligações. Em seguida, clique em “Choose this Number”;
- Para continuar, preencha seu endereço;
-
Congratulations! Agora você já possui um número na sua conta Twilio.
Home Assistant e Twilio
Agora que você já possui o número na sua conta Twilio, vamos iniciar a configuração no seu Home Assistant, para isso vamos configurar o componente Twilio.
Para isso, será necessário obter as informações account_sid e auth_token na sua conta Twilio. Acesse sua conta e pegue essas informações conforme a imagem abaixo.
Agora dentro do seu arquivo configuration.yaml , você precisa adicionar o seguinte código.
twilio:
account_sid: ACCOUNT_SID_FROM_TWILIO
auth_token: AUTH_TOKEN_FROM_TWILIO
Após inserior o código acima, você precisa adicionar seu número criado na conta Twilio, dentro do “notify:” em seu Home Assistant, conforme o código abaixo.
notify:
- name: NOTIFIER_NAME
platform: twilio_call
from_number: E164_PHONE_NUMBER #Atenção, esse número é o número obtido na conta Twilio, e não seu celular.
Testando e criando automação
Teste em serviços
Exemplo de automação:
automation:
- alias: The sun has set
trigger:
platform: homeassistant
event: start
action:
service: notify.twilio_call
data:
message: 'O seu home assistant foi iniciado'
target:
- +55DD9XXXXXXXX
- +55DD9XXXXXXXX
Exemplos de automações:
- Você pode criar uma automação para aniversários de familiares, desejando um feliz aniversário;
- Uma automação para lembrar de eventos na sua agenda google;
- Uma automação para informar que houve movimentação suspeita na sua residência e você deve checar suas câmeras;
Você pode verificar mais informações na documentação oficial do Home Assistant: https://www.home-assistant.io/components/twilio_call/
Observações:
- Você irá receber a ligação, e a primeira coisa que irá escutar é uma mensagem em inglês, informando que a conta é “trial”, basta pressionar qualquer tecla para ouvir a mensagem original.
- Você tem a opção de receber as ligações sem essa mensagem em inglês, atualizando sua conta realizando o pagamento de $ 20,00 com um cartão de crédito e $ 4 mensais a partir do próximo mês.
Dica
Para você alterar o idioma da sua mensagem, você pode utiliza o componente criado pela comunidade no link abaixo:
Resumindo o que precisa fazer:
Você baixa o arquivo custom_twilio.py
Coloca dentro da pasta python_scripts que fica na raiz dos seus arquivos (config), caso não tenha essa pasta, basta criar.
No seu arquivo de configuração (configuration.yaml), você precisa habilitar o python_script, conforme o código abaixo:
# Python Script - https://www.home-assistant.io/components/python_script/
python_script:
Atenção: Dentro do custom_twilio.py, você precisa editar a chamada do “hass.services.call” no final do arquivo, substituindo ‘twilio_test_call’ pelo nome do seu notificador.
Após isso, você pode testar com uma automação, ou um script como o exemplo abaixo:
twilio_custom_call:
sequence:
- service: python_script.custom_twilio
data:
delay: '1'
loop: '2'
voice: 'alice'
language: 'pt-BR'
speed: 'slow'
message: 'Testando se funciona o idioma'
phone: '+55489XXXXXXXX'
Ou pelo menu serviços como no exemplo abaixo: