# iMessage (Beta) Integre o iMessage na sua caixa de entrada unificada. Ligue um Mac com o [BlueBubbles](https://bluebubbles.app) e as suas mensagens iMessage fluirão para a plataforma juntamente com o WhatsApp, SMS, Instagram e Messenger — com o mesmo Agente de IA, Transmissões e histórico de contactos que já utiliza em todo o lado. > **Canal Beta.** O suporte para iMessage está atualmente disponível apenas por convite enquanto aperfeiçoamos a experiência. Contacte o suporte para o ativar na sua conta. A funcionalidade, os limites e o comportamento podem mudar à medida que o canal amadurece. --- ## Visão geral A Apple não oferece uma API oficial para o iMessage — um conjunto de regras que permitiria a outras aplicações ligarem-se diretamente ao iMessage. Em vez disso, esta integração liga-se através de uma aplicação de ponte de código aberto chamada **BlueBubbles**, que executa num Mac com sessão iniciada na sua conta iMessage. Uma vez ligado, a plataforma: - Recebe iMessages recebidas como novas conversas em Chats. - Envia respostas através do seu Mac, para que apareçam aos destinatários como uma iMessage normal de balão azul a partir do seu ID Apple. - Permite que o seu Agente de IA, etiquetas e registos de contactos funcionem exatamente como em qualquer outro canal. A configuração demora cerca de 10 minutos após ter o BlueBubbles instalado. --- ## O que precisa Para ligar o iMessage, precisará de tudo o que se segue: - **Um Mac** (portátil ou desktop) com sessão iniciada no seu Apple ID com o iMessage ativado na aplicação Mensagens. - **O Mac deve permanecer ligado e ativo.** Se o seu Mac entrar em modo de suspensão, reiniciar ou perder a ligação à Internet, as iMessages deixarão de ser recebidas até que volte a estar online. - **Servidor BlueBubbles** instalado nesse Mac — uma aplicação gratuita e de código aberto disponível em [bluebubbles.app](https://bluebubbles.app). - **Uma forma de expor o seu Mac à Internet** — normalmente um túnel como o Cloudflare Tunnel, ngrok ou Tailscale. O assistente de configuração do BlueBubbles guiá-lo-á neste processo. - **Um plano pago** — o iMessage está incluído como parte da sua quota de canais em todos os planos atuais. --- ## Configurar o BlueBubbles O BlueBubbles é uma aplicação de terceiros separada que instala no seu próprio Mac. Nós não a alojamos — ela corre localmente na sua máquina. 1. Transfira e instale o **BlueBubbles Server** a partir de [bluebubbles.app](https://bluebubbles.app). 2. Conceda as permissões solicitadas pelo instalador (Acessibilidade, Acesso Total ao Disco, Automatização). Estas permitem que o BlueBubbles leia as mensagens recebidas e acione a aplicação Mensagens para enviar as enviadas. 3. Abra o BlueBubbles → **Settings → API & Webhooks**. 4. Defina uma **palavra-passe do servidor**. 5. Copie o seu **URL do servidor** (um endereço público que aponta para o seu Mac). 6. Verifique no BlueBubbles se as mensagens de teste recebidas e enviadas funcionam localmente antes de prosseguir. > As instruções completas de configuração, resolução de problemas e guias específicos da plataforma encontram-se na [documentação oficial do BlueBubbles](https://docs.bluebubbles.app). Se tiver dificuldades com o próprio BlueBubbles, a documentação e a comunidade deles são o caminho mais rápido. --- ## Ligar o BlueBubbles à plataforma Assim que o BlueBubbles estiver a correr no seu Mac: 1. Na barra lateral esquerda, clique em **Settings** (Definições) perto da parte inferior. 2. Na barra lateral de Definições, em **Channels** (Canais), clique em **Channels**. 3. Encontre o cartão **iMessage** e clique em **Connect** (Ligar). (O botão **Connect** só se torna clicável quando o iMessage tiver sido ativado para a sua conta — até lá, aparece a cinzento e o cartão apresenta a nota "iMessage is in private beta and isn't enabled on your account yet.") 4. Cole o seu **Server URL** (URL do servidor) do BlueBubbles (por exemplo, `https://your-tunnel.example.com`). 5. Cole a sua **server password** (palavra-passe do servidor) do BlueBubbles. 6. Clique em **Connect**. Verificamos a ligação contactando o seu servidor BlueBubbles e configuramos o webhook automaticamente (um webhook é um endereço Web que permite ao BlueBubbles informar automaticamente a plataforma no momento em que chega uma nova mensagem). Se tudo estiver correto, o estado muda para **Connected**. 7. No BlueBubbles, abra **Settings → API & Webhooks → Webhooks** e confirme (ou cole) o URL do webhook apresentado na página de definições do iMessage. 8. Guarde. É tudo — as mensagens iMessage recebidas chegam agora à sua caixa de entrada em tempo real. ### Testar a Ligação A partir da página de definições do iMessage, pode enviar uma iMessage de teste para qualquer número de telefone para confirmar que tudo está ligado corretamente. Introduza o número de telefone do destinatário no formato E.164 (por exemplo, `+14155551234`) juntamente com uma mensagem curta e envie o teste. O primeiro envio de teste pode demorar até um minuto, porque a aplicação Mensagens no seu Mac pode precisar de iniciar uma nova conversa. Os envios subsequentes são quase instantâneos. --- ## Como fluem as mensagens ### Recebidas 1. Alguém envia uma iMessage para o seu ID Apple. 2. A aplicação Mensagens no seu Mac recebe-a (tal como o normal). 3. O BlueBubbles deteta a nova mensagem e envia-a (POST) para o URL do webhook. 4. A plataforma cria um contacto (se for novo), coloca a mensagem nos Chats e — se o seu Agente de IA para este canal estiver ativo — responde. ### Enviadas 1. Você ou a IA enviam uma resposta a partir da plataforma. 2. Enviamos a mensagem para o seu servidor BlueBubbles. 3. O BlueBubbles diz à aplicação Mensagens no seu Mac para enviar a iMessage. 4. O destinatário vê uma iMessage normal de balão azul a partir do seu ID Apple. ### Tipos de mensagens suportados - **Mensagens de texto** — totalmente suportadas em ambas as direções. - **Anexos e multimédia** — os anexos recebidos são visíveis no BlueBubbles, mas **ainda não** são ingeridos na plataforma durante a versão Beta. As mensagens enviadas devem conter texto — o envio de imagens ou ficheiros através do iMessage ainda não está disponível. --- ## Limites de envio, aquecimento e controlos de seguimento O iMessage tem o mesmo tipo de limites de envio de proteção, aquecimento automático e interruptor de segurança para seguimentos que o WhatsApp Web e o Telegram possuem, com uma diferença que vale a pena conhecer: **no iMessage, os seguimentos automáticos estão ativados por predefinição** numa conta recém-ligada, por isso desative-os se quiser que a conta permaneça inativa enquanto aquece. A Apple sinaliza agressivamente as contas que se comportam como remetentes em massa, pelo que estas proteções existem para manter o seu ID Apple seguro. Encontrará um cartão de **Limites de Envio e Aquecimento** e um interruptor de **Seguimentos Automáticos** na página de definições do iMessage assim que estiver ligado. ### Aquecimento automático (rampa) Uma conta iMessage recém-ligada é intencionalmente limitada e desbloqueia mais capacidade ao longo do tempo. Apenas ganha um "dia de qualificação" nos dias em que envia, efetivamente, pelo menos 75% do seu limite atual — os dias de inatividade não contam. - **Limite diário de mensagens** = `50 + 8 × (day − 1)`, limitado a **500/dia** (atingido no dia 58). - **Limite diário de novos contactos** = `floor((day − 1) × 5 / 6)`, limitado a **50/dia** (atingido no dia 61). A página de definições mostra o dia atual da rampa, a utilização de hoje face ao limite e quanto falta para atingir o objetivo. Se o seu ID Apple já tiver um longo histórico genuíno de iMessage, pode avançar o cursor do dia da rampa — mas faça-o apenas de forma honesta, para uma conta que realmente possua esse histórico. ### Substituição manual após a rampa Após a rampa completa de 58 dias, uma substituição opcional permite-lhe aumentar o limite diário de mensagens para além de 500 (de 750 até 5.000, em incrementos de 250 mensagens). Mantenha-se conservador — a Apple não publica um número seguro e o envio excessivo coloca o seu ID Apple em risco. A substituição só está disponível quando a conta estiver totalmente aquecida. ### Limites de envio ligados/desligados e interruptor de paragem de seguimento Um interruptor principal ativa ou desativa os limites de envio, e um limite diário de novos contactos permite-lhe definir um teto para os primeiros contactos mais baixo do que aquele que o aumento gradual permitiria. O interruptor de **Seguimentos Automáticos** interrompe todos os seguimentos automáticos para a conta, independentemente das definições de Transmissão/campanha. **No iMessage, este interruptor começa ativado**, pelo que uma conta recém-ligada enviará seguimentos automáticos até que os desative — e recomenda-se que os desative enquanto a conta for recente (menos de ~30 dias de aumento gradual). Quando o limite diário é atingido, os seguimentos agendados são adiados para o dia seguinte em vez de falharem. --- ## Limitações da versão Beta do iMessage Como o iMessage não possui uma API oficial, este canal apresenta restrições que não encontrará no WhatsApp, SMS ou Instagram. Por favor, reveja-as cuidadosamente antes de depender do iMessage para comunicações críticas para o seu negócio. - **O seu Mac deve permanecer ligado e ativo.** Sem Mac, sem iMessages. Recomendamos desativar o modo de suspensão no Mac que executa o BlueBubbles, ou utilizar um Mac mini dedicado para este efeito. - **Apenas conversas individuais, por número de telefone.** As conversas de grupo e os identificadores de ID Apple (e-mail) não são oficialmente suportados durante a versão Beta e podem comportar-se de forma inesperada se chegarem à plataforma — utilize apenas conversas iMessage individuais, por número de telefone. - **Apenas texto.** As mensagens apenas com anexos (fotografia, vídeo, ficheiro) são ignoradas na receção e os envios devem conter texto. O envio de multimédia será adicionado mais tarde na versão Beta. - **Sem modelos ou mensagens pré-aprovadas.** Todas as mensagens são texto de formato livre. - **Sem confirmações de entrega ou leitura** na interface da plataforma. Continuará a vê-las na aplicação Mensagens no seu Mac. - **Um estado "Enviado" significa entregue à aplicação, não ao destinatário.** Um estado "Enviado" significa que a plataforma entregou a mensagem ao seu Mac, não que o destinatário a recebeu. Como o iMessage não tem uma confirmação de entrega fiável, alguns envios são marcados como "Enviado" de forma otimista, mesmo quando o seu Mac não conseguiu confirmar a entrega (por exemplo, se o destinatário não estiver no iMessage). Para ter a certeza de que uma mensagem foi entregue, verifique a aplicação Mensagens no seu Mac. - **Os indicadores de escrita requerem a API Privada do BlueBubbles.** Quando a IA está a compor uma resposta, o seu contacto vê um balão de "a escrever..." — mas apenas se tiver ativado as funcionalidades da **API Privada** no BlueBubbles (Settings → Private API). Sem isto, as respostas são enviadas normalmente; o contacto simplesmente não verá o balão de escrita primeiro. - **A primeira mensagem enviada para um novo contacto pode ser lenta.** Iniciar uma conversa totalmente nova pode demorar entre 30 a 60 segundos enquanto o macOS abre o tópico; as mensagens subsequentes são rápidas. - **Sem envio em massa / transmissões.** Durante a versão Beta, o iMessage é melhor utilizado para conversas recebidas e respostas individuais, não para transmissões de saída de grande volume. A Apple limita agressivamente a taxa e sinaliza o tráfego automatizado do iMessage. - **Risco da conta.** A Apple não sanciona oficialmente a automatização de iMessage de terceiros. O uso excessivo ou de spam da automatização do iMessage pode resultar na sinalização ou restrição do seu ID Apple pela Apple. Utilize o canal de forma responsável. --- ## Resolução de Problemas ### "Não foi possível contactar o servidor BlueBubbles" - Confirme que o BlueBubbles está a ser executado no seu Mac e que o indicador verde **Servidor em execução** está visível. - Confirme que o seu túnel (Cloudflare / ngrok / Tailscale) está ativo e que o URL que colou é acessível a partir da internet pública — abra-o num navegador; deverá ver uma página de boas-vindas do BlueBubbles. - Verifique se a palavra-passe do servidor corresponde à definida em **BlueBubbles → Definições → API**. ### As mensagens recebidas não aparecem na caixa de entrada - Abra **BlueBubbles → Settings → API & Webhooks → Webhooks** e confirme que o URL do webhook que lhe mostrámos está guardado exatamente como apresentado. - A partir da página de definições do iMessage, utilize **Refresh status** para verificar se a ligação ainda está saudável. - Certifique-se de que o número do remetente é um número de telefone e não um endereço de e-mail (os identificadores de e-mail não são suportados na versão Beta). - Confirme que o seu Mac tem ligação à Internet e está ativo. ### Falha no envio de mensagens - Teste o mesmo destinatário diretamente a partir da aplicação Mensagens no seu Mac. Se a aplicação Mensagens também não conseguir enviar (por exemplo, o destinatário não está no iMessage), a plataforma também não conseguirá. - Certifique-se de que o seu Mac não está em suspensão, bloqueado com FileVault ou a apresentar uma janela de atualização do sistema — estes elementos bloqueiam a automatização AppleScript, da qual o BlueBubbles depende. - Confirme que tem créditos suficientes na sua conta. ### O estado mostra "Ligado" mas nada funciona - Utilize **Atualizar estado** na página de definições do iMessage para verificar novamente a ligação. - Se continuar a falhar, desligue e volte a ligar com um novo URL de servidor e palavra-passe. ### O meu Mac reiniciou / perdeu a ligação à internet Quando o seu Mac voltar a ficar online e o BlueBubbles reiniciar, a ligação será retomada automaticamente. Quaisquer mensagens que lhe tenham sido enviadas enquanto o Mac estava offline aparecerão na aplicação Mensagens assim que este voltar a ligar-se, mas podem **não** ser todas replicadas na plataforma — o iMessage não disponibiliza uma API fiável para recuperação de histórico. --- ## Precisa de ajuda? O iMessage encontra-se atualmente em **Beta**. Se encontrar problemas que não abordámos acima, contacte hi@youraiconnector.com com: - O URL do servidor que ligou (sem a palavra-passe). - Uma descrição do problema e quaisquer mensagens de erro da página de definições do iMessage. - A hora em que o problema ocorreu. Analisaremos a situação assim que possível.