# Existe uma API de SMS no iPhone? Como pegar as mensagens

> Não, o iOS não tem API pública que deixe um app ler as suas mensagens. Veja o que a Apple permite e como levar os SMS do iPhone ao seu código como JSON.

Última atualização: 2026-10-23
Página HTML canônica: https://www.fwrdsms.com/pt-br/blog/iphone-sms-api
Published: 2026-10-16

Não, não existe uma API pública de SMS no iPhone: o iOS não deixa um app ler as suas mensagens de texto, nem saber que uma chegou. O caminho permitido é uma automação de Mensagem que você monta uma vez no app Atalhos da Apple, que entrega cada mensagem que combina a uma ação. O Fwrd é essa ação para quem desenvolve: ele envia cada mensagem do iPhone para o seu próprio webhook HTTPS em JSON.

**O que você precisa:** um iPhone com iOS 26 ou posterior, o app Atalhos (ele já vem no celular) e um endpoint HTTPS que aceite um POST em JSON, como o seu próprio servidor ou um webhook do Zapier, Make ou n8n.

## Um app do iOS consegue ler SMS?

Não. Um app de terceiros no iOS não consegue ler a caixa de entrada do Mensagens e não é avisado quando chega uma mensagem. Todo jeito de tirar mensagens de um iPhone passa por algo que a pessoa configura de propósito.

Uma [resposta de 2017 nos fóruns de desenvolvedores da Apple](https://developer.apple.com/forums/thread/86268) diz isso com todas as letras: um app não pode ver as mensagens SMS, nem mesmo saber que elas chegaram. Em outubro de 2025, um engenheiro da Apple [disse nos fóruns](https://developer.apple.com/forums/thread/804040) que o macOS também não tem API para as mensagens SMS do usuário, então um Mac conectado à sua Conta Apple não é uma porta dos fundos.

## E o TelephonyMessagingKit?

O TelephonyMessagingKit existe, mas é só para apps que substituem o Mensagens como app padrão de mensagens da operadora, e só na União Europeia. Não é um jeito de um app comum ler as suas mensagens.

A [documentação da Apple](https://developer.apple.com/documentation/telephonymessagingkit) diz que o framework cuida de SMS, MMS e RCS no iPhone, mas o app precisa de uma permissão especial (entitlement), só funciona depois que a pessoa o escolhe como app padrão de mensagens da operadora, e a pessoa precisa de uma conta da UE com o aparelho na UE. Para [mensagens num script](https://www.fwrdsms.com/pt-br/blog/sms-otp-codes-ci-automation-iphone), num banco de dados ou num agente de IA, não é a ferramenta certa.

## Então como os apps preenchem os códigos de SMS?

Pelo preenchimento automático, não lendo a mensagem. O iOS identifica o código de uso único numa mensagem recebida e o oferece acima do teclado; o app só recebe o código quando a pessoa toca nele.

O guia da Apple sobre [ativar o preenchimento automático de senhas num campo de texto](https://developer.apple.com/documentation/security/enabling-password-autofill-on-a-text-input-view) lista o código de uso único como um tipo de conteúdo e diz que dá para completar automaticamente códigos de segurança vindos de logins por SMS. No UIKit, isso é `textContentType = .oneTimeCode`. Para um login mais fácil no seu próprio app, é tudo de que você precisa.

## Como levar as mensagens do iPhone para o seu código?

Monte uma automação de Mensagem no Atalhos e adicione a ação do Fwrd, que envia cada mensagem que combina do iPhone para o seu endpoint em JSON. O [acionador de Mensagem](https://support.apple.com/pt-br/guide/shortcuts/apdd711f9dff/ios) da Apple roda quando chega uma mensagem de um remetente que você adicionou ou com uma frase que você adicionou.

Estes passos usam o destino Webhook do Fwrd:

1. **Adicione um webhook no [Fwrd](https://apps.apple.com/app/apple-store/id6759069713?pt=128544281&ct=pt-blog-sms-api&mt=8).** Abra o Fwrd, toque em + e escolha Webhook. Cole o endereço HTTPS completo no campo “Configuration” (Configuração), toque em “Send Test Message” (Enviar mensagem de teste) para o seu endpoint ver os campos e depois salve.

2. **Crie uma automação de Mensagem.** No iOS 27, abra o Atalhos, toque em “Biblioteca”, depois em “Automação” e em +. Se aparecer “Descrever um atalho”, toque em “Editar”. Toque em “Automação” e depois em “Mensagem”. No iOS 26, abra a aba “Automação”, toque em + e escolha “Mensagem”.

3. **Escolha quais mensagens enviar.** Escolha “A Mensagem Contém” (no iOS 27, troque “Remetente” por “Mensagem”) e digite uma palavra que as suas mensagens contenham, como “code”. Ou digite um único espaço para enviar qualquer mensagem que tenha um.

4. **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”.

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

6. **Pronto.** As novas mensagens que contêm a sua palavra chegam ao seu endpoint sozinhas, com o iPhone desbloqueado ou bloqueado.

### Como é o JSON?

O Fwrd envia cada mensagem ao seu webhook como um POST com `Content-Type: application/json`. Por padrão, o corpo traz a mensagem exatamente como chegou, duas vezes, porque o Mattermost e o Rocket.Chat leem `text`:

```json
{
  "content": "Your code is 482913",
  "text": "Your code is 482913"
}
```

Não há data e hora. Se você ativar “Include Who Sent It” (Incluir quem enviou) nos Ajustes do Fwrd e escolher “Sender” (Remetente) na ação do Fwrd no Atalhos, o corpo também ganha um campo `sender`. Toda tentativa para a mesma mensagem leva o mesmo cabeçalho `Idempotency-Key`, para você descartar as repetidas. Qualquer resposta 2xx em até 15 segundos conta como entregue, e redirecionamentos são recusados. O [guia de webhook](https://www.fwrdsms.com/pt-br/guides/webhook) explica o lado do endpoint por completo.

## As suas opções, lado a lado

| Abordagem | Lê as mensagens recebidas? | Quem pode usar |
|---|---|---|
| Uma API pública de SMS | Não existe no iOS | Ninguém |
| TelephonyMessagingKit | Sim, como app padrão de mensagens | Apps de mensagens de operadora, só na UE |
| Preenchimento automático de senhas | Só o código, quando a pessoa toca nele | O campo de login de qualquer app |
| Atalhos + Fwrd | Sim, as mensagens que combinam com a sua automação | Qualquer pessoa com iOS 26 ou posterior |

O Fwrd faz essa parte por você:

- **Sem conta.** O Fwrd não tem login nem servidor do Fwrd; cada mensagem vai do seu iPhone direto para a sua URL.
- **Filtros.** Cada 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.
- **Novas tentativas e segredos resolvidos.** Se um envio expira, recebe um 429 ou 5xx ou perde a conexão, o Fwrd tenta de novo, até duas vezes, e guarda a sua URL nas Chaves do iPhone, não dentro de um atalho.
- **Oito destinos.** A mesma ação também cobre e-mail, outro telefone ou iMessage, WhatsApp, Discord, Slack, Microsoft Teams e Telegram.

## O que um iPhone não faz como gateway de SMS

Um iPhone não funciona como gateway de SMS para o seu servidor. O iOS não tem API que deixe um servidor enviar uma mensagem por ele, então o Fwrd só recebe: as mensagens chegam no iPhone e saem para o seu endpoint.

- **Enviar a partir de uma API.** Os apps de gateway que enviam SMS a partir de uma API rodam no Android; o [textbee.dev](https://textbee.dev) diz nas perguntas frequentes que hoje só funciona em aparelhos Android (informação de 16 de outubro de 2026).
- **É preciso uma regra.** A automação age nas mensagens com uma palavra que você escolhe, ou de pessoas dos seus Contatos. Um único espaço pega qualquer mensagem que tenha um espaço.
- **O celular fica ligado e online.** O iPhone que recebe as mensagens precisa estar ligado, com Wi-Fi ou dados celulares, quando elas chegam. Depois de reiniciar, o encaminhamento espera você desbloqueá-lo uma vez.
- **Só texto.** Imagens não passam, e as respostas continuam saindo do próprio iPhone.

## Perguntas que vêm depois

### Posso ler mensagens antigas que já estão no meu iPhone?

Não. A automação de Mensagem só roda para as mensagens novas que chegam depois que você a configura.

### Funciona com Zapier, Make ou n8n?

Sim. Cole um catch hook do Zapier, um custom webhook do Make ou a production URL de um nó Webhook do n8n no destino Webhook do Fwrd, e cada mensagem que combina inicia o seu fluxo. [Envie mensagens do iPhone para Zapier, Make ou n8n](https://www.fwrdsms.com/pt-br/iphone-sms-to-zapier-make-n8n) tem os passos de cada um.

### As iMessages contam?

Sim. A automação de Mensagem roda para as mensagens que chegam no app Mensagens, incluindo as iMessages, então uma iMessage que combina chega ao seu webhook do mesmo jeito que um SMS.

### Quanto custa?

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 SMS do iPhone para um webhook](https://www.fwrdsms.com/pt-br/iphone-sms-to-webhook)
- [Como funcionam as automações de mensagem do Atalhos no iPhone](https://www.fwrdsms.com/pt-br/blog/iphone-shortcuts-message-automation)