Ligação com Twilio

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

  1. Acesse o site https://www.twilio.com e crie uma conta com seu e-mail;
  2. Após criar a conta, você precisa confirmar através de seu e-mail;
  3. 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;
  4. Em seguida, o site Twilio irá realizar alguns questionamento para lhe conhecer melhor. As respostas são indiferentes, ou seja, pode selecionar qualquer resposta.
  5. 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

  1. Com a conta criada e autenticada, clique no menu ao lado esquerdo, na opção “All Products & Services”;
  2. Em seguida, selecione a opção “Programmable Voice”;
    Programmable Voice
  3. Selecione a opção “Numbers”;
  4. Clique no botão “Get Number”;
  5. Você receberá um novo número. Esse número será o que irá realizar as ligações. Em seguida, clique em “Choose this Number”;
  6. Para continuar, preencha seu endereço;
  7. 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
Twilio - Serviços HA

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:
python_script.custom_twilio

Eles estão me fornecendo um número gringo e não um com prefixo 55 do Brasil… Tem problema?

Não, o número que fornecem sempre é gringo mesmo.