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

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 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 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 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, 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 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 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. 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:

{
  "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 explica o lado do endpoint por completo.

As suas opções, lado a lado

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 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.