Alexa Notifications - JRInge/ha GitHub Wiki

Voice Monkey Alex Skill allows HA to use web hooks to trigger Alex notifications. To use, enable the skill, set up 'monkeys' (triggers) on the Voice Monkey website, then set up routines in the Alexa app to respond to the triggers.

RESTfull Command to provide HA service that triggers Voice Monkey:

rest_command:
  voice_monkey:
    url: https://api.voicemonkey.io/trigger
    method: POST
    verify_ssl: true
    content_type: 'application/json'
    payload: !secret voice_monkey_template

The payload template is held in secrets.yaml to protect the Voice Monkey API tokens. It looks like this:

voice_monkey_template: >-
  {
    "access_token": "ACCESS_TOKEN",
    "secret_token": "SECRET_TOKEN",
    "monkey": "{{ monkey }}",
    "announcement": "{{ message }}",
    "image": "{{ image }}",
    "video": "{{ video }}",
    "websiteUrl": "{{ url }}"
  }

It's called in a script or automation like this:

service: rest_command.voice_monkey
data:
  monkey: alexa-phone-monkey
  message: It's working!
  url: 'https://voicemonkey.io/docs'