# Envie as mensagens do iPhone para o Home Assistant

> Transforme as mensagens que chegam no iPhone em automações do Home Assistant com um acionador de webhook, aberto para a internet, lendo o texto em JSON.

Última atualização: 2026-10-23
Página HTML canônica: https://www.fwrdsms.com/pt-br/blog/iphone-texts-to-home-assistant
Published: 2026-10-18

Para enviar as mensagens do iPhone para o Home Assistant, dê a uma automação um acionador de webhook, consiga um endereço HTTPS para ele pelo Home Assistant Cloud ou pelo seu próprio domínio e faça uma automação de Mensagem do Atalhos enviar cada mensagem nova para esse endereço. O Home Assistant lê o texto como `trigger.json`, então uma mensagem do seu alarme pode acender uma luz ou anunciar uma entrega numa caixa de som.

**Do que você precisa:** um iPhone que recebe as mensagens, um servidor Home Assistant e um endereço HTTPS para ele, pelo Home Assistant Cloud (Nabu Casa) ou pelo seu próprio domínio e proxy reverso. Para usar o Fwrd, você também precisa do iOS 26 ou posterior.

## Como uma mensagem chega ao Home Assistant?

Por um webhook. Nenhum app consegue ler as suas mensagens por conta própria, então uma automação do Atalhos entrega cada mensagem que combina a uma ação que a envia para o endereço de webhook do Home Assistant.

A [documentação de acionadores de automação](https://www.home-assistant.io/docs/automation/trigger/#webhook-trigger) do Home Assistant (lida em 18 de outubro de 2026) diz que o endereço é `/api/webhook/` seguido do ID do seu webhook, e que ele é criado assim que você define o ID num acionador. Ela também diz que o JSON enviado para ele fica disponível como `trigger.json`, desde que a requisição seja enviada como `application/json`, que é o que o Fwrd faz.

## Como enviar as mensagens do iPhone para o Home Assistant

1. **Crie a automação.** No Home Assistant, vá em “Settings”, depois em “Automations & scenes”, em “Create automation” e em “Create new automation”. Na seção “When”, selecione “Add trigger”, adicione um acionador “Webhook” e deixe o “Webhook ID” como está.

2. **Escolha como o iPhone chega até ele.** A documentação do Home Assistant diz que, por padrão, os webhooks só respondem a aparelhos da mesma rede ou a webhooks do Nabu Casa Cloud. Com o Home Assistant Cloud, deixe “Only accessible from the local network” (só acessível pela rede local) ativado. Com o seu próprio domínio ou proxy reverso, selecione a engrenagem ao lado do “Webhook ID” e desmarque essa opção, porque o seu iPhone envia de onde ele estiver.

3. **Pegue o endereço HTTPS.** Com o Home Assistant Cloud, salve a automação, vá em “Settings” e depois em “Cloud”, role até o cartão de webhooks e selecione “Manage” ao lado do seu webhook. O [artigo sobre webhooks](https://support.nabucasa.com/hc/en-us/articles/25619382358685) do Nabu Casa (lido em 18 de outubro de 2026) diz que a janela mostra uma URL única para ele. Com o seu próprio domínio, o endereço é `https://`, o seu domínio, depois `/api/webhook/` e o ID.

4. **Adicione um destino Webhook no [Fwrd](https://apps.apple.com/app/apple-store/id6759069713?pt=128544281&ct=pt-blog-home-assistant&mt=8).** Abra o Fwrd, toque em + e escolha Webhook. Cole o endereço HTTPS completo em “Configuration” (Configuração). Toque em “Send Test Message” (Enviar mensagem de teste) e salve com a marca de seleção.

5. **Crie uma automação de Mensagem no Atalhos.** No iOS 27, abra o Atalhos, toque em “Biblioteca”, depois em “Automação” e em +, e escolha “Mensagem”. No iOS 26, abra a aba “Automação”, toque em + e escolha “Mensagem”. Escolha “A Mensagem Contém” e digite uma palavra que as suas mensagens tenham em comum, como alarme, ou alarm se elas chegam em inglês.

6. **Faça a automação rodar sem perguntar.** No iOS 27, toque na seta ao lado do acionador e verifique que “Confirmar Antes de Executar” está desativado. Em ⓘ, depois em “Privacidade”, verifique que “Permitir Execução Quando Bloqueado” está ativado. No iOS 26, escolha “Executar Imediatamente”, toque em “Seguinte” e depois em “Criar Novo Atalho”.

7. **Adicione a ação do Fwrd.** Pesquise por “Forward” e adicione “Forward Message to All Destinations” (Encaminhar Mensagem para Todos os Destinos). Defina o campo “Message” (Mensagem) dela como “Entrada do Atalho” (no iOS 26, “Entrada do Atalho” e depois “Mensagem”). Toque em “Voltar” para salvar (“OK” no iOS 26).

8. **Pronto.** As novas mensagens com a sua palavra-chave chegam ao Home Assistant sozinhas, com o iPhone desbloqueado ou bloqueado.

O [guia de webhook](https://www.fwrdsms.com/pt-br/guides/webhook) tem todas as telas do Fwrd, e [Encaminhe SMS do iPhone para um webhook](https://www.fwrdsms.com/pt-br/iphone-sms-to-webhook) explica a requisição por completo.

Watch the setup video on the [setup guide](https://www.fwrdsms.com/pt-br/guides/webhook).

### Como fica a automação em YAML?

O corpo que o Fwrd envia é `{"content": "…", "text": "…"}`, os dois com o texto exatamente como chegou, então a automação lê `trigger.json.content`. Esta acende a luz da varanda quando uma mensagem fala do alarme:

```yaml
alias: Alarm text turns on the porch light
triggers:
  - trigger: webhook
    webhook_id: "a-long-random-id-only-you-know"
    allowed_methods:
      - POST
    local_only: false # only needed without Home Assistant Cloud
conditions:
  - condition: template
    value_template: "{{ 'alarm' in trigger.json.content | lower }}"
actions:
  - action: light.turn_on
    target:
      entity_id: light.porch
```

A linha `local_only: false` só é necessária sem o Home Assistant Cloud. Se as suas mensagens de alarme vêm em português, troque `'alarm'` pela palavra que elas contêm. Troque a ação por um anúncio numa caixa de som, e a mensagem “saiu para entrega” de uma transportadora pode avisar a casa que uma encomenda está chegando. Ative “Include Who Sent It” (Incluir quem enviou) nos Ajustes do Fwrd e preencha o campo “Sender” (Remetente) na ação do Fwrd, e o corpo também ganha um campo `sender`, que você lê como `trigger.json.sender`.

## O que o Fwrd acrescenta ao webhook?

O destino Webhook do Fwrd faz o envio, então a automação tem uma só ação:

- **Filtros.** O destino de webhook pode ficar só com as mensagens que têm as palavras que você escolher, as que parecem um código de verificação ou as que chegam em certos horários. “Try a Text” (Testar uma mensagem) confere um filtro com uma mensagem de exemplo. Uma mensagem que um filtro descarta não gasta um encaminhamento grátis.
- **Uma mensagem, vários lugares.** A mesma ação pode enviar a mensagem para o Home Assistant e para um chat da família no Slack, Discord, Telegram ou Teams ao mesmo tempo.
- **Novas tentativas sem repetição.** Se um envio expira ou o servidor está ocupado, o Fwrd tenta de novo, até duas vezes, com o mesmo cabeçalho `Idempotency-Key` a cada vez.
- **O endereço fica privado.** O Fwrd guarda a URL nas Chaves do iPhone, não dentro de um atalho. Não há conta nem servidor do Fwrd; cada mensagem vai do seu iPhone direto para o Home Assistant.
- **Um histórico no celular.** Ele mostra cada encaminhamento e se o Home Assistant o aceitou.

## Os limites que você precisa conhecer

- **O ID do webhook é a senha.** A documentação do Home Assistant diz que os webhooks não pedem nenhum outro login, então use um ID longo e impossível de adivinhar e guarde-o em segredo. O Fwrd não adiciona cabeçalhos de login.
- **Não use isso para abrir fechaduras.** A mesma documentação desaconselha automações de webhook que abrem uma fechadura ou um portão de garagem. Luzes, caixas de som e notificações combinam melhor.
- **O Fwrd precisa de um endereço HTTPS público.** Ele recusa endereços IP e nomes terminados em .local, e recusa redirecionamentos, então cole o endereço final. Uma URL de webhook na nuvem exige uma assinatura do Home Assistant Cloud.
- **O celular precisa ficar ligado e online.** Só as novas mensagens que combinam com a automação são enviadas, e depois de reiniciar o encaminhamento espera você desbloquear o iPhone uma vez.

## Perguntas que vêm depois

### O Home Assistant consegue ler o texto da mensagem?

Sim. O Fwrd envia o texto inteiro em `content` e em `text`, então um template como `trigger.json.content` o contém. Você pode procurar palavras numa condição, colocar o texto numa notificação ou fazer uma caixa de som lê-lo em voz alta.

### Preciso do Home Assistant Cloud?

Não. Qualquer endereço HTTPS que chegue ao seu servidor funciona, como o seu próprio domínio atrás de um proxy reverso. A [página de acesso remoto](https://www.home-assistant.io/docs/configuration/remote/) do Home Assistant (lida em 18 de outubro de 2026) diz que o Home Assistant Cloud é a opção mais fácil, sem portas do roteador para abrir.

### Funciona quando estou fora de casa?

Sim, por uma URL de webhook do Home Assistant Cloud ou pelo seu próprio domínio HTTPS público, depois que “Only accessible from the local network” estiver desativado. O iPhone envia por Wi-Fi ou dados celulares, onde quer que esteja.

### Quanto custa o Fwrd?

O Fwrd é grátis para até 15 encaminhamentos por mês, e uma mensagem conta uma vez, não importa para quantos lugares ela vá. O Fwrd Pro tira o limite por $4.99 por mês ou $29.99 por ano nos EUA. A App Store mostra o preço na sua própria moeda.

## Continue lendo

- [Encaminhe mensagens de alarmes e sensores para um grupo de chat](https://www.fwrdsms.com/pt-br/blog/forward-alarm-sensor-texts-to-group-chat)
- [Como enviar um webhook pelo Atalhos da Apple](https://www.fwrdsms.com/pt-br/blog/apple-shortcuts-webhook)
