Dialogflow
The Dialogflow integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] is designed to be used with the webhook
To be able to receive messages from Dialogflow, your Home Assistant instance needs to be accessible from the web and you need to have the external URL configured. Dialogflow will return fallback answers if your server does not answer or takes too long (more than 5 seconds).
Dialogflow could be integrated
After the Conversational Actions sunset on June 13, 2023
Using Dialogflow will be easy to create conversations like:
User: What is the temperature at home?
Bot: The temperature is 34 degrees
User: Turn on the light
Bot: In which room?
User: In the kitchen
Bot: Turning on kitchen light
To use this integration, you should define a conversation (intent) in Dialogflow, configure Home Assistant with the speech to return and, optionally, the action to execute.
Configuring your Dialogflow account
To get the webhook URL, go to the integrations page in the configuration screen and find “Dialogflow”. Click on “configure”. Follow the instructions on the screen.
-
Login
with your Google account. - Click on “Create Agent”.
- Select name, language (if you are planning to use Google Actions check their supported languages
) and time zone. - Click “Save”.
- Now go to “Fulfillment” (in the left menu).
- Enable Webhook and set your Dialogflow webhook URL as the endpoint, e.g.,
https://myhome.duckdns.org/api/webhook/800b4cb4d27d078a8871656a90854a292651b20635685f8ea23ddb7a09e8b417
- Click “Save”.
- Create a new intent.
- Below “User says” type one phrase that you, the user, will say to Dialogflow, e.g.,
What is the temperature at home?
. - In “Action” enter an action name. This should match the name of an IntentScript within your Home Assistant configuration, e.g., in the example below “Temperature”.
- In “Response” enter “Cannot connect to Home Assistant or it is taking to long” (fall back response).
- At the bottom of the page, expand “Fulfillment” and check “Use webhook”.
- Click “Save”.
- At the top right of the screen where it says “Try it now…”, type, or say, the phrase you have previously defined and hit enter.
- Dialogflow will now send a request to your Home Assistant instance and display the response.
The V1 API will be deprecated on October 23, 2019. If you are still using the V1 API, it is recommended to change your settings in Dialogflow to use the V2 API. No changes to your intents YAML configuration need to take place after upgrading to the V2 API. Change to the V2 API by clicking on the cog button here
Take a look to “Integrations”, in the left menu, to configure third parties.
Configuring Home Assistant
When activated, the alexa
integration will have Home Assistant’s native intent support handle the incoming intents. If you want to run actions based on intents, use the intent_script
integration.
Examples
Download this zip
# Example configuration.yaml entry
dialogflow:
intent_script:
Temperature:
speech:
text: The temperature at home is {{ states('sensor.home_temp') }} degrees
LocateIntent:
speech:
text: >
{%- for state in states.device_tracker -%}
{%- if state.name.lower() == User.lower() -%}
{{ state.name }} is at {{ state.state }}
{%- elif loop.last -%}
I am sorry, I do not know where {{ User }} is.
{%- endif -%}
{%- else -%}
Sorry, I don't have any trackers registered.
{%- endfor -%}
WhereAreWeIntent:
speech:
text: >
{%- if is_state('device_tracker.adri', 'home') and
is_state('device_tracker.bea', 'home') -%}
You are both home, you silly
{%- else -%}
Bea is at {{ states("device_tracker.bea") }}
and Adri is at {{ states("device_tracker.adri") }}
{% endif %}
TurnLights:
speech:
text: Turning {{ Room }} lights {{ OnOff }}
actions:
- action: notify.pushbullet
data:
message: Someone asked via apiai to turn {{ Room }} lights {{ OnOff }}
- action: >
{%- if OnOff == "on" -%}
switch.turn_on
{%- else -%}
switch.turn_off
{%- endif -%}
target:
entity_id: "switch.light_{{ Room | striptags | replace(' ', '_') }}"