iMessage (Beta)
Integre o iMessage na sua caixa de entrada unificada. Ligue um Mac com o BlueBubbles 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.
- 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.
- Transfira e instale o BlueBubbles Server a partir de bluebubbles.app.
- 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.
- Abra o BlueBubbles → Settings → API & Webhooks.
- Defina uma palavra-passe do servidor.
- Copie o seu URL do servidor (um endereço público que aponta para o seu Mac).
- 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. 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:
- Na barra lateral esquerda, clique em Settings (Definições) perto da parte inferior.
- Na barra lateral de Definições, em Channels (Canais), clique em Channels.
- 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.”)
- Cole o seu Server URL (URL do servidor) do BlueBubbles (por exemplo,
https://your-tunnel.example.com). - Cole a sua server password (palavra-passe do servidor) do BlueBubbles.
- 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.
- No BlueBubbles, abra Settings → API & Webhooks → Webhooks e confirme (ou cole) o URL do webhook apresentado na página de definições do iMessage.
- 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
- Alguém envia uma iMessage para o seu ID Apple.
- A aplicação Mensagens no seu Mac recebe-a (tal como o normal).
- O BlueBubbles deteta a nova mensagem e envia-a (POST) para o URL do webhook.
- 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
- Você ou a IA enviam uma resposta a partir da plataforma.
- Enviamos a mensagem para o seu servidor BlueBubbles.
- O BlueBubbles diz à aplicação Mensagens no seu Mac para enviar a iMessage.
- 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.