iMessage (Beta) #

Traga o iMessage para sua caixa de entrada unificada. Conecte um Mac executando o BlueBubbles 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.
• 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.
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. 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.