Como encaminhar mensagens de texto do iPhone para um webhook

Atualizado em

Direto do Fwrd

O seu próprio endpoint HTTPS

Envie mensagens selecionadas do iPhone para um endpoint HTTPS que você controla.

Como este destino funciona

O Fwrd envia cada mensagem correspondente por HTTPS, direto do iPhone para este destino, sempre que o destino estiver ativo no Fwrd.

Encaminhe SMS do iPhone para um webhook: visão geral e perguntas frequentes

Antes de começar

  • Um endpoint HTTPS que é seu ou que você tem autorização para usar
  • O endpoint aceita um POST em JSON e responde com um status 2xx
  • Fwrd instalado no iPhone que recebe as mensagens
Configuração usada neste guia: URL do endpoint HTTPS

Configure o destino

9 etapas

A configuração do Fwrd nestas etapas exige o iOS 27. No iOS 26, adicione o destino Webhook como mostrado em “Monte você mesmo”.

  1. Aceite a solicitação do Fwrd

    O Fwrd envia uma solicitação POST com um corpo JSON que traz o texto original da mensagem duas vezes, em um campo content e em um campo text, para que os serviços que leem um ou outro o recebam. Se você ativar “Include Who Sent It” (Incluir quem enviou) nos Ajustes do Fwrd e escolher “Remetente” na ação do Fwrd no Atalhos, o corpo também traz um campo sender. Responda com qualquer status 2xx para a entrega contar como concluída. Redirecionamentos são recusados, então informe o endereço final.

    {"content": "Your message", "text": "Your message"}
  2. Ignore as tentativas repetidas

    Se uma solicitação falhar, o Fwrd pode tentar de novo. Toda tentativa para a mesma mensagem leva o mesmo cabeçalho Idempotency-Key, então o seu endpoint pode descartar as repetições.

  3. Mantenha a URL em segredo

    O Fwrd não adiciona cabeçalhos de autenticação. Se o seu endpoint exige um segredo, coloque-o na URL. O Fwrd guarda o endereço inteiro nas Chaves do iPhone.

  4. Escolha “Webhook” na configuração do Fwrd

    No iPhone, abra o Fwrd e toque em “Configurar o envio” no fim da introdução. Quando ele perguntar para onde as suas mensagens devem ir, escolha “Webhook”.

  5. Cole a URL no Fwrd

    Cole o endereço HTTPS inteiro em “URL do webhook”, depois continue.

    “URL do webhook” ← Seu endpoint HTTPS
  6. Adicione o atalho pronto

    Escolha quais mensagens encaminhar. Toque em “Obter atalho”. No Atalhos, toque em “Adicionar Atalho” e depois em ◀ Fwrd, no canto superior esquerdo.

  7. Ative o atalho

    Toque em “Abrir atalho”. No Atalhos, toque em “Editar”, toque em › após “em que” (não no ×) e ative “Automação”.

  8. Permita a primeira execução

    O Fwrd roda o atalho uma vez com uma mensagem de exemplo, o que conta como um encaminhamento. Na primeira vez, o Atalhos pergunta duas vezes: toque em “Permitir” e depois em “Permitir Sempre”.

  9. Tudo pronto

    Pronto. As novas mensagens correspondentes vão para o seu endpoint sozinhas, com o iPhone desbloqueado ou bloqueado. Depois que o iPhone reiniciar, desbloqueie-o uma vez e o encaminhamento continua.

Monte você mesmo

No iOS 26, ou para montar a automação você mesmo, siga estas etapas. Se o Fwrd já encaminha para algum lugar, pare assim que o destino Webhook for salvo: a sua automação envia para todos os destinos ativos.

Veja a configuração

Cada toque no Fwrd e no Atalhos no iOS 27, em menos de um minuto. Pause em qualquer passo ou escolha um abaixo para ir até ele.

Mostrado no iOS 27 com o Fwrd 1.1. Os endereços e números são exemplos.

  1. Adicione “Webhook” no Fwrd

    No iPhone, abra o Fwrd, toque em + na parte de baixo da tela e escolha “Webhook”. Você pode renomeá-lo para distinguir os destinos.

  2. Cole a URL no Fwrd

    Cole o endereço HTTPS inteiro no campo “Configuration” (Configuração).

    “Configuration” (Configuração) ← Seu endpoint HTTPS
  3. Salve e mantenha o destino ativo

    Toque em “Send Test Message” (Enviar mensagem de teste) e depois na marca de seleção, no canto superior direito, para salvar. Se o iOS oferecer salvar uma senha, toque em “Agora Não”: o Fwrd já a guarda nas Chaves do iPhone. Deixe “Destination Active” (Destino ativo) ativado. Um destino inativo continua salvo no iPhone, mas é ignorado quando as mensagens chegam.

    “Destination Active” (Destino ativo) ← Ativado
  4. Crie uma automação de Mensagem

    No iPhone que recebe, abra o Atalhos. No iOS 27, vá em “Biblioteca” → “Automação” e toque em +. Se você vir “Descrever um atalho”, toque em “Editar”. Toque em “Automação”, depois em “Mensagem”, e troque “Remetente” por “Mensagem”. Digite uma palavra que as suas mensagens contenham, como code ou verificação: filtrar pela mensagem pega códigos curtos e remetentes fora dos seus Contatos, o que “Remetente” não consegue. Depois 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, toque em “Automação”, depois em + e em “Mensagem”, e escolha “Executar Imediatamente”.

    “Mensagem contém” ← sua palavra · “Confirmar Antes de Executar” ← desativado · “Permitir Execução Quando Bloqueado” ← ativado
    Etapa do acionador aberta pela seta: “Automação” ativada e “Confirmar Antes de Executar” desativado
  5. Adicione a ação “Forward Message” do Fwrd

    Pesquise por “Forward” e adicione “Forward Message to All Destinations” (Encaminhar Mensagem para Todos os Destinos) do Fwrd abaixo do acionador. Toque em “Mensagem” nela, toque em “Selecionar Variável” e escolha “Entrada do Atalho”; o Atalhos adiciona um bloco “Receber … como entrada” no topo, o que não tem problema. Toque em “Voltar” para salvar. No iOS 26, toque primeiro em “Criar Novo Atalho” e depois adicione a ação: a “Mensagem” dela é preenchida com “Entrada do Atalho”. Toque em “OK”.

    “Mensagem” = “Entrada do Atalho”
    Ação do Fwrd com o texto “Forward Shortcut Input to all destinations” (Encaminhar Entrada do Atalho para todos os destinos), com um bloco “Receber … como entrada” adicionado no topo
  6. Tudo pronto

    Pronto. As novas mensagens correspondentes vão para o seu endpoint sozinhas, com o iPhone desbloqueado ou bloqueado. Depois que o iPhone reiniciar, desbloqueie-o uma vez e o encaminhamento continua.

As telas do Atalhos mudam entre o iOS 26 e o iOS 27. O guia da automação mostra as duas.

Se uma mensagem não chegar

O Fwrd marca a tentativa como “Failed” (Falhou)
O seu endpoint precisa responder com um status 2xx em até 15 segundos. O Fwrd não segue redirecionamentos, então use o endereço final.
A mesma mensagem chega duas vezes
O Fwrd tenta de novo quando uma solicitação falha ou demora demais. Descarte qualquer solicitação cuja Idempotency-Key você já viu.
O conteúdo não é o que eu esperava
O Fwrd envia JSON com os campos content e text, ambos com o texto original da mensagem exatamente como chegou. Não há horário nem título. Um campo sender só é adicionado se você ativar “Include Who Sent It” (Incluir quem enviou) nos Ajustes do Fwrd e escolher “Remetente” na ação do Fwrd no Atalhos.

Os problemas que valem para todos os destinos, como mensagens que nunca disparam a automação, estão no guia de solução de problemas.

Perguntas comuns

Bom saber

Mantenha o iPhone que recebe as mensagens ligado e online. Depois de reiniciar, desbloqueie-o uma vez e o encaminhamento continua. Cada encaminhamento aparece em “Activity” (Atividade) no Fwrd.