# iMessage (Beta) Traga o iMessage para sua caixa de entrada unificada. Conecte um Mac executando o [BlueBubbles](https://bluebubbles.app) e suas mensagens do iMessage fluirão para a plataforma junto com WhatsApp, SMS, Instagram e Messenger — com o mesmo Agente de IA, Transmissões e histórico de contatos que você já usa em todos os outros lugares. > **Canal Beta.** O suporte ao iMessage está disponível apenas por convite enquanto refinamos a experiência. Entre em contato com o suporte para ativá-lo em 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 que outros aplicativos se conectassem diretamente ao iMessage. Em vez disso, esta integração conecta-se através de um aplicativo de ponte de código aberto chamado **BlueBubbles**, que você executa em um Mac conectado à sua conta do iMessage. Uma vez conectado, a plataforma: - Recebe iMessages recebidas como novas conversas em Chats. - Envia respostas de saída através do seu Mac, para que apareçam aos destinatários como um iMessage normal de bolha azul do seu Apple ID. - Permite que seu Agente de IA, tags e registros de contatos funcionem exatamente como funcionam em qualquer outro canal. A configuração leva cerca de 10 minutos após a instalação do BlueBubbles. --- ## O que você precisa Para conectar o iMessage, você precisará de tudo o que segue: - **Um Mac** (laptop ou desktop) conectado ao seu Apple ID com o iMessage ativado no aplicativo Mensagens. - **O Mac deve permanecer online e ativo.** Se o seu Mac entrar em repouso, reiniciar ou perder a conexão com a internet, os iMessages param de fluir até que ele esteja online novamente. - **BlueBubbles Server** instalado nesse Mac — um aplicativo gratuito de código aberto disponível em [bluebubbles.app](https://bluebubbles.app). - **Uma maneira de expor seu Mac à internet** — normalmente um túnel como Cloudflare Tunnel, ngrok ou Tailscale. O assistente de configuração do BlueBubbles o guiará por isso. - **Um plano pago** — o iMessage está incluído como parte da sua franquia de canais em todos os planos atuais. --- ## Configurando o BlueBubbles O BlueBubbles é um aplicativo de terceiros separado que você instala no seu próprio Mac. Nós não o hospedamos — ele é executado localmente na sua máquina. 1. Baixe e instale o **BlueBubbles Server** em [bluebubbles.app](https://bluebubbles.app). 2. Conceda as permissões solicitadas pelo instalador (Acessibilidade, Acesso Total ao Disco, Automação). Elas permitem que o BlueBubbles leia mensagens recebidas e acione o aplicativo Mensagens para enviar as de saída. 3. Abra o BlueBubbles → **Settings → API & Webhooks**. 4. Defina uma **senha de servidor**. 5. Copie sua **URL de servidor** (um endereço público que aponta para o seu Mac). 6. Verifique no BlueBubbles se as mensagens de teste de entrada e saída funcionam localmente antes de prosseguir. > As instruções completas de configuração, solução de problemas e guias específicos da plataforma estão na [documentação oficial do BlueBubbles](https://docs.bluebubbles.app). Se você tiver dificuldades com o próprio BlueBubbles, a documentação e a comunidade deles são o caminho mais rápido. --- ## Conectando o BlueBubbles à plataforma Assim que o BlueBubbles estiver sendo executado no seu Mac: 1. Na barra lateral esquerda, clique em **Settings** perto da parte inferior. 2. Na barra lateral de Settings, em **Channels**, clique em **Channels**. 3. Encontre o cartão **iMessage** e clique em **Connect**. (O botão **Connect** só se torna clicável quando o iMessage tiver sido habilitado para sua conta — até lá, ele fica cinza e o cartão exibe a nota "iMessage is in private beta and isn't enabled on your account yet.") 4. Cole a **Server URL** do seu BlueBubbles (por exemplo, `https://your-tunnel.example.com`). 5. Cole a **server password** do seu BlueBubbles. 6. Clique em **Connect**. Verificamos a conexão entrando em contato com seu servidor BlueBubbles e configuramos o webhook automaticamente (um webhook é um endereço da web que permite que o BlueBubbles informe automaticamente à plataforma no momento em que uma nova mensagem chega). Se tudo estiver correto, o status muda para **Connected**. 7. No BlueBubbles, abra **Settings → API & Webhooks → Webhooks** e confirme (ou cole) a URL do webhook mostrada na página de configurações do iMessage. 8. Salve. É isso — as mensagens recebidas do iMessage agora chegam à sua caixa de entrada em tempo real. ### Testando a Conexão Na página de configurações do iMessage, você pode enviar um iMessage de teste para qualquer número de telefone para confirmar se tudo está conectado corretamente. Insira o número de telefone do destinatário no formato E.164 (por exemplo, `+14155551234`) junto com uma mensagem curta e envie o teste. O primeiro envio de teste pode levar até um minuto, pois o aplicativo Mensagens no seu Mac pode precisar iniciar um novo tópico de conversa. Os envios subsequentes são quase instantâneos. --- ## Como as Mensagens Fluem ### Recebimento 1. Alguém envia um iMessage para o seu Apple ID. 2. O aplicativo Mensagens no seu Mac o recebe (como de costume). 3. O BlueBubbles detecta a nova mensagem e faz um POST para a URL do webhook. 4. A plataforma cria um contato (se for novo), coloca a mensagem em Chats e — se o seu Agente de IA para este canal estiver ativo — ele responde. ### Envio 1. Você ou a IA enviam uma resposta da plataforma. 2. Enviamos a mensagem para o seu servidor BlueBubbles. 3. O BlueBubbles instrui o aplicativo Mensagens no seu Mac a enviar o iMessage. 4. O destinatário vê um iMessage normal de bolha azul do seu Apple ID. ### Tipos de Mensagem Suportados - **Mensagens de texto** — totalmente suportadas em ambas as direções. - **Anexos e mí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 arquivos via iMessage ainda não está disponível. --- ## Limites de envio, aquecimento e controles de acompanhamento O iMessage possui o mesmo tipo de limites de envio de proteção, aquecimento automático e interruptor de desligamento de acompanhamento que o WhatsApp Web e o Telegram possuem, com uma diferença que vale a pena saber: **no iMessage, os acompanhamentos automatizados são ativados por padrão** em uma conta recém-conectada, portanto, desative-os você mesmo se quiser que a conta permaneça silenciosa enquanto ela aquece. A Apple sinaliza agressivamente contas que se comportam como remetentes em massa, então essas proteções existem para manter seu ID Apple seguro. Você encontrará um cartão de **Limites de Envio e Aquecimento** e uma alternância de **Acompanhamentos Automatizados** na página de configurações do iMessage assim que estiver conectado. ### Aquecimento automático (rampa) Uma conta do iMessage recém-conectada é intencionalmente limitada e desbloqueia mais capacidade ao longo do tempo. Ela ganha um "dia de qualificação" apenas nos dias em que realmente envia pelo menos 75% do seu limite atual — dias ociosos 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 contatos** = `floor((day − 1) × 5 / 6)`, limitado a **50/dia** (atingido no dia 61). A página de configurações mostra o dia atual da rampa, o uso de hoje em relação ao limite e quanto falta para atingir o objetivo. Se o seu Apple ID já possui um longo histórico genuíno de iMessage, você pode mover o controle deslizante do dia da rampa para frente — mas faça isso apenas com honestidade, para uma conta que realmente possua esse histórico. ### Substituição manual além da rampa Após a rampa completa de 58 dias, uma substituição opcional permite que você aumente o limite diário de mensagens acima 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 seu Apple ID em risco. A substituição só está disponível quando a conta estiver totalmente aquecida. ### Limites de envio ativado/desativado e interruptor de segurança para acompanhamentos Uma alternância principal ativa ou desativa os limites de envio, e um teto diário de novos contatos permite que você limite os primeiros contatos a um valor menor do que o permitido pela rampa. A alternância de **Acompanhamentos Automatizados** interrompe todos os acompanhamentos automatizados da conta, independentemente das configurações de Transmissão/campanha. **No iMessage, essa alternância começa ligada**, portanto, uma conta recém-conectada enviará acompanhamentos automatizados até que você a desligue — e desligá-la é recomendado enquanto a conta for nova (menos de ~30 dias de rampa). Quando o limite diário é atingido, os acompanhamentos agendados são transferidos para o dia seguinte em vez de falharem. --- ## Limitações do iMessage Beta Como o iMessage não possui uma API oficial, este canal vem com restrições que você não verá no WhatsApp, SMS ou Instagram. Por favor, analise-as cuidadosamente antes de confiar no iMessage para mensagens críticas de negócios. - **Seu Mac deve permanecer online e ativo.** Sem Mac, sem iMessages. Recomendamos desativar o repouso no Mac que executa o BlueBubbles ou usar um Mac mini dedicado para isso. - **Apenas conversas individuais com número de telefone.** Chats em grupo e identificadores de Apple ID (e-mail) não são oficialmente suportados durante o Beta e podem se comportar de forma inesperada se chegarem à plataforma — use apenas conversas de iMessage individuais com número de telefone. - **Apenas texto.** Mensagens apenas com anexos (foto, vídeo, arquivo) são ignoradas na entrada, e os envios de saída devem conter texto. O envio de mídia será adicionado posteriormente no 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. Você ainda as verá no aplicativo Mensagens no seu Mac. - **Um status "Enviado" significa entregue à rede, não recebido.** Um status "Enviado" significa que a plataforma entregou a mensagem ao seu Mac, não que o destinatário a recebeu. Como o iMessage não possui confirmação de entrega confiável, alguns envios são marcados como "Enviado" de forma otimista, mesmo quando seu Mac não pôde confirmar a entrega (por exemplo, se o destinatário não estiver no iMessage). Para ter certeza de que uma mensagem foi entregue, verifique o aplicativo Mensagens no seu Mac. - **Indicadores de digitação exigem a API Privada do BlueBubbles.** Quando a IA está compondo uma resposta, seu contato vê uma bolha de "digitando..." — mas apenas se você tiver ativado os recursos de **Private API** no BlueBubbles (Settings → Private API). Sem isso, as respostas ainda são enviadas normalmente; o contato apenas não verá a bolha de digitação primeiro. - **A primeira mensagem de saída para um novo contato pode ser lenta.** Iniciar uma conversa totalmente nova pode levar de 30 a 60 segundos enquanto o macOS abre o thread; as mensagens subsequentes são rápidas. - **Sem envio em massa / disparos de transmissão.** Durante o Beta, o iMessage é melhor usado para conversas de entrada e respostas individuais, não para transmissões de saída de alto 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 automação de iMessage de terceiros. O uso excessivo ou de spam da automação do iMessage pode resultar na sinalização ou restrição do seu Apple ID pela Apple. Use o canal com responsabilidade. --- ## Solução de problemas ### "Não foi possível contatar o servidor BlueBubbles" - Confirme se o BlueBubbles está sendo executado no seu Mac e se o indicador verde **Server running** está visível. - Confirme se o seu túnel (Cloudflare / ngrok / Tailscale) está ativo e se a URL que você colou é acessível pela internet pública — abra-a em um navegador; você deverá ver uma página de boas-vindas do BlueBubbles. - Verifique se a senha do servidor corresponde à definida em **BlueBubbles → Settings → API**. ### Mensagens recebidas não aparecem na caixa de entrada - Abra **BlueBubbles → Settings → API & Webhooks → Webhooks** e confirme se a URL do webhook que mostramos está salva exatamente como exibida. - Na página de configurações do iMessage, use **Refresh status** para verificar se a conexão ainda está saudável. - Certifique-se de que o número do remetente seja um número de telefone, não um endereço de e-mail (identificadores de e-mail não são suportados no Beta). - Confirme se o seu Mac tem conectividade com a internet e está ativo. ### Falha no envio de mensagens de saída - Teste o mesmo destinatário diretamente pelo aplicativo Mensagens no seu Mac. Se o Messages.app 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 seu Mac não esteja em repouso, bloqueado com FileVault ou exibindo uma caixa de diálogo de atualização do sistema — isso bloqueia a automação via AppleScript, da qual o BlueBubbles depende. - Confirme se você possui créditos suficientes em sua conta. ### O status mostra "Conectado", mas nada funciona - Use **Atualizar status** na página de configurações do iMessage para verificar a conexão novamente. - Se ainda assim falhar, desconecte e reconecte com uma nova URL de servidor e senha. ### Meu Mac reiniciou / perdeu a internet Quando seu Mac volta a ficar online e o BlueBubbles é reiniciado, a conexão é retomada automaticamente. Quaisquer mensagens enviadas a você enquanto o Mac estava offline aparecerão no aplicativo Mensagens assim que ele se reconectar, mas elas podem **não** ser todas replicadas na plataforma — o iMessage não expõe uma API de preenchimento confiável. --- ## Precisa de ajuda? O iMessage está atualmente em **Beta**. Se você encontrar problemas que não abordamos acima, entre em contato com hi@youraiconnector.com com: - A URL do servidor que você conectou (sem a senha). - Uma descrição do problema e quaisquer mensagens de erro da página de configurações do iMessage. - O horário em que o problema ocorreu. Daremos uma olhada assim que possível.