Skip to content

Threema Integration Docs#44160

Open
LukasQ wants to merge 5 commits intohome-assistant:nextfrom
LukasQ:threema-integration
Open

Threema Integration Docs#44160
LukasQ wants to merge 5 commits intohome-assistant:nextfrom
LukasQ:threema-integration

Conversation

@LukasQ
Copy link

@LukasQ LukasQ commented Mar 17, 2026

Add user documentation for the new Threema integration targeting HA 2026.4. Covers E2E encrypted messaging via Threema Gateway, config flow setup, send_message action, and QR code verification entity.

Proposed change

Privacy matters. Threema is one of the few messengers that doesn't require a phone number, is fully end-to-end encrypted by default, and is open source. With over 12 million users — especially popular in the DACH region — it's a natural fit for Home Assistant
This integration brings Threema Gateway support to HA Core, enabling users to send secure text messages from their automations. It supports both E2E encrypted and simple transport modes, key pair generation during setup, and a QR code entity for identity verification — staying true to Threema's security-first philosophy.

Logos and Code PRs

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings March 17, 2026 12:35
@home-assistant home-assistant bot added has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels Mar 17, 2026
@netlify
Copy link

netlify bot commented Mar 17, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 09c7978
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/69bbc8310d786b0008a86848
😎 Deploy Preview https://deploy-preview-44160--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request adds new user-facing documentation for the Threema integration, but it also bundles a large set of broader documentation edits, site layout/accessibility changes (TOC + “back to top”), redirects, and dependency bumps across the docs website.

Changes:

  • Add new integration docs for Threema (Gateway-based encrypted messaging) and Heatit, plus a new Litter-Robot blueprint.
  • Update many existing docs pages for wording, structure, and consistency (for example, “Result:”/“Troubleshooting:” formatting, new/remodeled sections).
  • Update the docs site UI and infrastructure: TOC behavior, new back-to-top button, heading-level changes in includes, redirects cleanup, and Ruby/Node dependency updates.

Reviewed changes

Copilot reviewed 142 out of 197 changed files in this pull request and generated 9 comments.

Show a summary per file
File Description
source/voice_control/worlds-most-private-voice-assistant.markdown Minor formatting cleanup.
source/voice_control/voice_remote_local_assistant.markdown Copy edits and formatting improvements.
source/voice_control/voice_remote_cloud_assistant.markdown Adds local-guide link, formatting tweaks.
source/voice_control/using_tts_in_automation.markdown Disables TOC for page.
source/voice_control/troubleshooting_the_s3_box.markdown “Result” formatting normalization.
source/voice_control/thirteen-usd-voice-remote.markdown “Troubleshooting/Result” formatting normalization.
source/voice_control/s3_box_voice_assistant.markdown “Troubleshooting” formatting normalization.
source/voice_control/s3-box-customize.markdown “Result” formatting normalization.
source/voice_control/install_wake_word_add_on.markdown Wording changes; duplicated bullets introduced.
source/voice_control/index.markdown Reworded intro and expanded satellite options list.
source/voice_control/create_wake_word.markdown Formatting changes; duplicated bullets introduced.
source/voice_control/apple.markdown Adds iOS Voice Control accessibility trigger steps.
source/voice_control/android.markdown Formatting and spacing cleanup.
source/more-info/unsupported/source_mods.markdown Removes page content (deleted file).
source/more-info/unsupported/content_trust.markdown Removes page content (deleted file).
source/ios/nfc.markdown Removes placeholder landing page (deleted file).
source/ios/index.markdown Removes redirect stub (deleted file).
source/ios/dev-auth.markdown Removes redirect stub (deleted file).
source/ios/beta.markdown Removes redirect stub (deleted file).
source/ios/beta-auth.markdown Removes redirect stub (deleted file).
source/android/index.markdown Removes redirect stub (deleted file).
source/installation/raspberrypi.markdown “Troubleshooting” formatting normalization.
source/installation/index.html Terminology change to “microSD memory card”.
source/images/getting-started/weather_card_details_01.png Adds/updates onboarding screenshot asset.
source/images/getting-started/onboarding_pick_different_card_01.png Adds/updates onboarding screenshot asset.
source/images/getting-started/onboarding_edit_dashboard_01.png Adds/updates onboarding screenshot asset.
source/images/getting-started/onboarding_dashboard_delete_card.png Adds/updates onboarding screenshot asset.
source/images/getting-started/onboarding_dashboard_01.png Adds/updates onboarding screenshot asset.
source/images/getting-started/onboarding_card_settings_02.png Adds/updates onboarding screenshot asset.
source/images/getting-started/onboarding_card_settings_01.png Adds/updates onboarding screenshot asset.
source/images/dashboards/dashboards-add-dashboard-selector.png Dashboard selector screenshot update/removal use.
source/green/styles.css Landing page style tweaks.
source/green/index.html Heading hierarchy adjustments; hero H1 consolidation.
source/getting-started/onboarding_dashboard.markdown Restructures dashboard onboarding steps.
source/getting-started/onboarding.markdown Disables TOC; “Result” formatting normalization.
source/getting-started/join-the-community.markdown Disables TOC.
source/dashboards/views.markdown “Result” formatting normalization.
source/dashboards/dashboards.markdown Updates dashboard option naming; result formatting.
source/dashboards/cards.markdown Expanded intro; fixes links; refines instructions.
source/dashboards/badges.markdown Major rewrite: description, related links, text polish.
source/common-tasks/os.markdown “Troubleshooting” formatting normalization.
source/changelogs/core-2026.3.markdown Adds 2026.3.1 and 2026.3.2 patch notes.
source/blueprints/integrations/litterrobot_clean_area_on_cycle.yaml New blueprint for vacuum cleaning after cycle.
source/_redirects Adds redirects for removed pages; adds webhook redirect.
source/_layouts/default.html TOC markup change; adds back-to-top button.
source/_integrations/zwave_js.markdown “Troubleshooting” formatting normalization.
source/_integrations/zha.markdown Clarifies IEEE address casing requirement.
source/_integrations/wled.markdown Restructures into “Supported functionality”.
source/_integrations/webhook.markdown Removes legacy redirect page (deleted file).
source/_integrations/waterfurnace.markdown Adds “Removing the integration” section.
source/_integrations/vesync.markdown Adds a supported humidifier model.
source/_integrations/vacuum.markdown Adds area-mapping + automation guidance section.
source/_integrations/uhoo.markdown Adds “Influenza index” sensor mention.
source/_integrations/tplink_omada.markdown Adds OC220 controller to supported list.
source/_integrations/timer.markdown Trailing whitespace cleanup.
source/_integrations/threema.markdown New integration docs for Threema messaging.
source/_integrations/thread.markdown “Troubleshooting” formatting normalization.
source/_integrations/tesla_fleet.markdown Clarifies redirect URI options.
source/_integrations/telegram_bot.markdown Updates chat ID instructions; adds trusted networks note.
source/_integrations/switchbot_cloud.markdown Updates app navigation path for token/secret.
source/_integrations/spotify.markdown Updates prerequisites (Premium requirement note).
source/_integrations/smartthings.markdown Adds diagnostics section + feature request guidance.
source/_integrations/slide_local.markdown Trailing whitespace cleanup.
source/_integrations/slack.markdown Trailing whitespace cleanup.
source/_integrations/sky_remote.markdown Adds spacing between command groups.
source/_integrations/siren.mqtt.markdown Fixes YAML formatting for description block.
source/_integrations/simplisafe.markdown Trailing whitespace cleanup.
source/_integrations/simplepush.markdown Fixes heading spacing.
source/_integrations/simplefin.markdown Trailing whitespace cleanup.
source/_integrations/signal_messenger.markdown Reformats setup requirements section.
source/_integrations/shell_command.markdown Trailing whitespace cleanup.
source/_integrations/seventeentrack.markdown Removes package-level attributes section.
source/_integrations/serial.markdown Fixes YAML key spacing.
source/_integrations/sensor.rest.markdown Documents scan_interval; improves timeout description.
source/_integrations/sensor.mqtt.markdown Fixes code fence formatting.
source/_integrations/script.markdown Trailing whitespace cleanup.
source/_integrations/schedule.markdown Trailing whitespace cleanup.
source/_integrations/saunum.markdown Moves supported devices section; updates blueprint link.
source/_integrations/saj.markdown Trailing whitespace cleanup.
source/_integrations/russound_rio.markdown Trailing whitespace cleanup.
source/_integrations/proxmoxve.markdown Major rewrite: prerequisites, permissions, troubleshooting.
source/_integrations/plaato.markdown Fixes list indentation and spacing.
source/_integrations/ping.markdown Trailing whitespace cleanup.
source/_integrations/pilight.markdown Trailing whitespace cleanup.
source/_integrations/picnic.markdown Trailing whitespace cleanup; small wording fixes.
source/_integrations/philips_js.markdown Trailing whitespace cleanup.
source/_integrations/persistent_notification.markdown Fixes line wrapping.
source/_integrations/openai_conversation.markdown Adds prerequisites section; clarifies endpoint limitation.
source/_integrations/ollama.markdown Updates FAQ link target.
source/_integrations/media_player.markdown Removes outdated “only supported on …” claim.
source/_integrations/matter.markdown Fixes spacing in troubleshooting bullet.
source/_integrations/mastodon.markdown Adds use cases; clarifies account detail behavior.
source/_integrations/litterrobot.markdown Adds supported devices, data updates, examples, limitations.
source/_integrations/leviton_z_wave.markdown Adds supported devices list; adjusts heading level.
source/_integrations/indevolt.markdown Updates prerequisites step; textlint directives added.
source/_integrations/immich.markdown Fixes YAML example commas.
source/_integrations/heatit.markdown New brand integration page (Z-Wave WWHA).
source/_integrations/google_drive.markdown Adds UI navigation to open Drive folder.
source/_integrations/ghost.markdown Updates quality scale and minimum Ghost version.
source/_integrations/fritzbox_callmonitor.markdown Adds DECT repeater caveat.
source/_integrations/denonavr.markdown Adds Marantz AV8805 to supported list.
source/_integrations/blueprint.markdown Removes legacy redirect page (deleted file).
source/_integrations/automation.markdown Removes legacy redirect page (deleted file).
source/_integrations/anthropic.markdown Adds “AI” category.
source/_integrations/airobot.markdown Restructures use cases/examples; updates blueprint link.
source/_integrations/airgradient.markdown Trailing whitespace cleanup.
source/_integrations/aftership.markdown Trailing whitespace cleanup.
source/_integrations/acaia.markdown Trailing whitespace cleanup.
source/_includes/site/sidebar.html Changes heading tags for sidebar sections.
source/_includes/site/footer.html Removes external-link icons from footer links.
source/_includes/post/sharing.html Changes heading tag for sharing section.
source/_includes/javascripts/scripts.html Adds back-to-top + TOC “current section” JS.
source/_includes/integrations/option_flow.md Rewrites option flow steps + adds screenshot.
source/_includes/installation/container.md Updates Docker Engine minimum version guidance.
source/_includes/custom/news.html Changes heading tags in homepage news include.
source/_includes/common-tasks/update.md “Troubleshooting” formatting normalization.
source/_includes/common-tasks/third-party-addons.md “Result” formatting normalization.
source/_includes/common-tasks/network_storage.md “Troubleshooting” formatting normalization.
source/_includes/common-tasks/file_access.md Expands file editor basepath instructions.
source/_includes/common-tasks/data_disk.md “Result” formatting normalization.
source/_includes/common-tasks/beta_version.md “Troubleshooting” formatting normalization.
source/_includes/common-tasks/backups.md “Result” formatting normalization.
source/_includes/asides/voice_navigation.html Changes headings; retains icon markup in sidebar.
source/_includes/asides/recent_posts.html Changes heading tags.
source/_includes/asides/recent_categories.html Changes heading tags.
source/_includes/asides/organizing_navigation.html Changes heading tags.
source/_includes/asides/installation_navigation.html Changes heading tags.
source/_includes/asides/help_navigation.html Changes heading tags; removes external icon.
source/_includes/asides/hassio_navigation.html Changes heading tags.
source/_includes/asides/getting_started_navigation.html Changes heading tags; removes external icons.
source/_includes/asides/faq_navigation.html Changes heading tags.
source/_includes/asides/docs_sitemap.html Removes external icons; link formatting tweaks.
source/_includes/asides/docs_navigation.html Changes heading tags.
source/_includes/asides/dashboards_navigation.html Changes heading tags; removes external icon markup.
source/_includes/asides/conference_navigation.html Changes heading tags.
source/_includes/asides/component_navigation.html Changes heading tags.
source/_includes/asides/common_tasks_navigation.html Changes heading tags.
source/_includes/asides/cloud_navigation.html Changes heading tags.
source/_includes/asides/categories.html Changes heading tags.
source/_includes/asides/about.html Changes heading tags; removes external icons.
source/_faq/release.markdown Trailing whitespace cleanup.
source/_docs/tools/dev-tools.markdown Trailing whitespace cleanup.
source/_docs/tools.markdown Disables TOC.
source/_docs/scripts/conditions.markdown Line wrap cleanup.
source/_docs/scene.markdown Fixes YAML key spacing.
source/_docs/organizing/labels.markdown “Result” formatting normalization.
source/_docs/organizing/floors.markdown “Result” formatting normalization.
source/_docs/organizing/categories.markdown “Result” formatting normalization.
source/_docs/organizing/areas.markdown Expands content; adds new sections and steps.
source/_docs/organizing.markdown Clarifies grouping behavior; list formatting.
source/_docs/locked_out.md “Troubleshooting” formatting normalization.
source/_docs/energy/water.markdown Trailing whitespace cleanup.
source/_docs/energy/gas.markdown Trailing whitespace cleanup.
source/_docs/energy.markdown Disables TOC.
source/_docs/configuration/troubleshooting.markdown Reworks debug logs/diagnostics steps.
source/_docs/configuration/splitting_configuration.markdown Trailing whitespace cleanup.
source/_docs/configuration/packages.markdown Trailing whitespace cleanup.
source/_docs/configuration/customizing-devices.markdown Removes image; “Result” formatting normalization.
source/_docs/configuration/basic.markdown “Troubleshooting” formatting normalization.
source/_docs/blueprint/tutorial.markdown Trailing whitespace cleanup.
source/_docs/blueprint/selectors.markdown Fixes trailing spaces.
source/_docs/backend.markdown Disables TOC; trailing whitespace cleanup.
source/_docs/automation/modes.markdown Trailing whitespace cleanup.
source/_docs/automation/editor.markdown “Result” formatting normalization.
source/_docs/automation/condition.markdown Disables TOC.
source/_docs/automation/action.markdown Disables TOC.
source/_docs/authentication/providers.markdown Trailing whitespace cleanup.
source/_docs/authentication/multi-factor-auth.markdown “Result” formatting normalization; whitespace cleanup.
source/_data/products.yml Updates distributor URLs; adds new distributor.
source/_dashboards/sections.markdown Documents footer editing + footer YAML options.
source/_dashboards/picture.markdown Trailing whitespace cleanup.
source/_dashboards/markdown.markdown Trailing whitespace cleanup.
source/_dashboards/logbook.markdown Trailing whitespace cleanup.
source/_dashboards/gauge.markdown Fixes trailing spaces.
source/_dashboards/energy.markdown Adds show_only_totals config option.
source/_dashboards/conditional.markdown Trailing whitespace cleanup.
source/_dashboards/calendar.markdown Fixes broken alt text line wrapping.
sass/homeassistant/base/_navigation.scss Adjusts header grid layout behavior.
sass/homeassistant/base/_global.scss Adds responsive padding-top adjustments.
sass/homeassistant/base/_back_to_top.scss New styles for back-to-top button.
sass/homeassistant/_overrides.scss Major TOC styling overhaul; removes external-link icon CSS.
sass/homeassistant/_homeassistant.scss Imports back-to-top styles.
plugins/output_modder.rb Stops auto-appending external-link icons.
package-lock.json Bumps Node dependencies (hono + node-server).
_config.yml Updates Algolia key; bumps patch version + date.
Gemfile.lock Bumps Ruby gems; adds ostruct.
Gemfile Bumps sass-embedded/rubocop/ruby-lsp; adds ostruct.
.vscode/cSpell.json Adds “Airobot” and “Saunum” to dictionary.
.gitignore Ignores .claude directory.
.github/copilot-instructions.md Adds inclusive language guidance entry.

You can also share your feedback on Copilot code review. Take the survey.

Add user documentation for the new Threema integration targeting HA 2026.4.
Covers E2E encrypted messaging via Threema Gateway, config flow setup,
send_message action, and QR code verification entity.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@LukasQ LukasQ force-pushed the threema-integration branch from c40cc3d to e6eab79 Compare March 17, 2026 12:57
Use standalone automation snippet format (starting with alias:)
instead of invalid top-level automations: key.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@LukasQ

This comment was marked as outdated.

@c0ffeeca7 c0ffeeca7 added awaits-parent Awaits the merge of an parent PR new-integration This PR adds documentation for a new Home Assistant integration and removed awaits-parent Awaits the merge of an parent PR labels Mar 17, 2026
@LukasQ
Copy link
Author

LukasQ commented Mar 19, 2026

Created a new core PR as FUBAR-ed my local git config.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants