Twitter integration: rename to X (#29403)

This commit is contained in:
c0ffeeca7 2023-10-18 19:51:25 +02:00 committed by GitHub
parent a2bc0c675d
commit bec3ac5e6e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,6 +1,6 @@
---
title: Twitter
description: Instructions on how to add Twitter notifications to Home Assistant.
title: X
description: Instructions on how to add X notifications to Home Assistant.
ha_category:
- Notifications
ha_release: 0.12
@ -11,18 +11,18 @@ ha_platforms:
ha_integration_type: integration
---
The `twitter` notification platform uses [Twitter](https://twitter.com) to deliver notifications from Home Assistant.
The `twitter` notification platform uses [X](https://twitter.com) to deliver notifications from Home Assistant.
## Setup
Make sure you have a developer account registered with Twitter, then go to [Twitter Apps](https://developer.twitter.com/en/portal/dashboard) and create an application. If you don't have a developer account you need to apply for one, it can take some time to get approved.
Make sure you have a developer account registered with X, then go to [X Apps](https://developer.twitter.com/en/portal/dashboard) and create an application. If you don't have a developer account you need to apply for one, it can take some time to get approved.
### App permissions
If you do not perform this step, your application will only receive read permissions and will not be able to post tweets on behalf of your account on Twitter.
If you do not perform this step, your application will only receive read permissions and will not be able to post tweets on behalf of your account on X.
1. Visit "Settings" of the application.
2. Click on `Set up` under "User authentication settings".
1. Visit **Settings** of the application.
2. Select `Set up` under **User authentication settings**.
3. Check the box for `OAuth 1.0a`.
4. Set the app permission to `Read and write`.
5. Enter a `callback` and `website` URL and click save.
@ -31,13 +31,13 @@ It does not matter for the integration what you enter as a callback or website U
### Generate tokens and secrets
1. Visit "Keys and tokens" of the application.
2. Click on `Regenerate` under "Consumer keys" to get your **Consumer Key** and **Consumer Secret**.
3. Click on `Regenerate` under "Access Tokens and Secret" to get your **Access Token** and **Access Token Secret**.
1. Visit **Keys and tokens** of the application.
2. Select `Regenerate` under **Consumer keys** to get your **Consumer Key** and **Consumer Secret**.
3. Select `Regenerate` under **Access Tokens and Secret** to get your **Access Token** and **Access Token Secret**.
## Configuration
To add Twitter to your installation, add the following to your `configuration.yaml` file:
To add X to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
@ -73,7 +73,7 @@ access_token_secret:
required: true
type: string
username:
description: "Twitter handle without `@` or with `@` and quoting for direct messaging."
description: "X handle without `@` or with `@` and quoting for direct messaging."
required: false
type: string
{% endconfiguration %}