MeiMei
Iniciar sessão

Suporte

Implemente o MeiMei Phone Assistant com um telemóvel real, um backend ativo e um caminho de configuração claro.

Configuração, emparelhamento, chamadas de teste, atualizações de firmware e resolução de problemas para o modelo USB e o modelo Wi-Fi.

Como o MeiMei Phone Assistant trata uma chamada

O telemóvel continua na rede móvel real. O MeiMei Phone Assistant emparelha por Bluetooth HFP, envia o áudio e o estado da chamada para o seu backend próprio por USB ou Wi-Fi, e deixa o agente do backend falar de volta através do telemóvel.

O que acontece após o pagamento

O Stripe confirma o pagamento e a encomenda aparece na sua página de Conta. Depois preparamos os seus dispositivos, enviamo-los dentro do prazo do seu pacote e atualizamos o estado da encomenda à medida que avança. As questões de configuração, a garantia legal e as devoluções são tratadas por e-mail através da página de Suporte.

Como é que o MeiMei Phone Assistant se liga ao meu telemóvel?

O dispositivo emparelha com o telemóvel por Bluetooth HFP, como um kit mãos-livres. O telemóvel continua na rede real do operador, enquanto o dispositivo reencaminha o estado da chamada e o áudio para o seu backend alojado por si, através de um cabo USB (modelo USB) ou da sua rede Wi-Fi (modelo Wi-Fi).

O que inclui a configuração inicial?

Transfira o pacote appliance do MeiMei a partir da página de suporte e execute o assistente de configuração (setup.sh no macOS ou Linux, setup.ps1 no Windows) com o Docker em execução. O assistente pede as chaves dos seus fornecedores de IA e uma palavra-passe para o painel de controlo, oferece algumas funcionalidades opcionais e depois inicia o assistente. Em seguida, ligue o dispositivo: um modelo USB mantém-se no cabo e usa o pequeno programa de reencaminhamento USB que o assistente de configuração indica; um modelo Wi-Fi recebe os dados da sua rede Wi-Fi uma única vez através do MeiMei Firmware Updater. Por fim, emparelhe o telemóvel por Bluetooth e faça uma chamada de teste.

Que fornecedores de IA posso usar?

Para a conversa, use a sua própria chave da OpenAI, Anthropic Claude, Google Gemini, xAI Grok, Mistral, Meta Muse Spark (através do OpenRouter) ou OpenRouter, execute um modelo local com o Ollama ou use qualquer endpoint compatível com a OpenAI. Para ouvir é necessária uma chave de reconhecimento de voz da OpenAI, Meta ou Deepgram, ou um servidor compatível com whisper que gira por si; esta versão não inclui reconhecimento de voz offline. As respostas faladas usam a voz Edge online integrada, sem chave, ou uma voz de um fornecedor que configure. Uma única chave da OpenAI cobre as três etapas.

Quanto custa a utilização?

O dispositivo é uma compra única e não cobramos nada por chamada. Cada fornecedor de IA fatura-lhe diretamente na sua própria conta; com o MeiMei AI, é a MeiMei que fatura a sua utilização. Exemplos, preços publicados pelos fornecedores em setembro de 2026 e faturados pelo fornecedor: voz em tempo real GPT-Live-1 0,05 USD por minuto; Muse Spark 1.3 1,25 USD por milhão de tokens de entrada e 4,25 USD por milhão de tokens de saída; reconhecimento de voz Muse Voice Transcribe 0,18 USD por hora de áudio (o romeno não é suportado). Os preços podem mudar; confirme junto do fornecedor antes de escolher. O separador Models do painel de controlo mostra uma estimativa por dispositivo.

O que são o "Muse Live" e a voz em tempo real, e qual devo usar para romeno?

Por predefinição, cada chamada usa o pipeline de voz: reconhecimento de voz, depois o seu modelo de conversa, depois síntese de voz. O "Muse Live" no MeiMei é esse pipeline construído com serviços da Meta (Muse Voice Transcribe, depois Muse Spark, depois síntese de voz); não é um serviço de voz para voz da Meta, porque a Meta não oferece uma API para programadores desse tipo. Os modelos Muse de nível contributor servem apenas para testes e não são oferecidos nas instalações de clientes. A voz em tempo real é um modo opcional separado, em pré-visualização: por dispositivo, no separador Models do painel de controlo, o GPT-Live-1 atende a chamada diretamente com a sua própria chave da OpenAI, com processamento na UE disponível; se uma sessão em tempo real falhar, o pipeline assume. O romeno ainda não está confirmado para o GPT-Live-1: mantenha o pipeline para quem liga em romeno e ative o tempo real só depois da sua própria chamada de teste.

Existe uma subscrição ou um serviço alojado?

Não. O dispositivo é uma compra única e o software do assistente corre inteiramente no seu próprio computador. As chaves dos seus fornecedores de IA ficam na sua configuração local, não há telemetria, e o único custo recorrente é o que o fornecedor de IA escolhido cobrar pela utilização (ou, se escolher o MeiMei AI, o respetivo preço por utilização). As atualizações de firmware e de software são gratuitas.

O agente também pode fazer chamadas de saída?

Sim. Quando uma sessão do dispositivo está ligada, o backend pode enviar um comando de marcação ao telemóvel emparelhado — incluindo através do endpoint MCP, para que o Claude ou qualquer cliente MCP possa fazer chamadas e enviar SMS com tokens por dispositivo. As chamadas recebidas e efetuadas usam o mesmo pipeline de áudio e o mesmo encaminhamento do agente.

Onde ficam o histórico de chamadas e as transcrições?

No seu próprio backend alojado por si, não no dispositivo nem em nenhum serviço na nuvem. O backend guarda transcrições, resumos, a identidade de quem liga e a memória do agente por interlocutor, e pode geri-los a partir do painel de controlo web no seu computador.

Como são tratadas as atualizações e a recuperação?

As atualizações de firmware são gratuitas e instalam-se apenas através do cabo USB, com a aplicação de ambiente de trabalho MeiMei Firmware Updater (versão 0.2.0 ou posterior, para macOS e Windows), nunca por Wi-Fi nem pela internet: a aplicação transfere a atualização feita para o seu dispositivo e grava-a através do cabo. Não há limite de chamadas: o dispositivo não conta chamadas e nunca exige uma atualização após um certo número de chamadas, por isso é você quem decide quando atualizar. No modelo Wi-Fi, ligue o cabo à placa principal, a que tem o ecrã. Consulte a secção 7 do manual abaixo.

Manual de implementação

O manual de implementação está disponível em todos os idiomas do site.

Este manual cobre uma primeira implementação completa: instalar o software do assistente no seu computador, ligar o dispositivo, emparelhar o telemóvel, fazer uma chamada de teste, ajustar o assistente no painel de controlo e manter o dispositivo atualizado.

1. Instalar o software do assistente

O assistente corre no Docker num computador seu que fica ligado (Windows, macOS ou Linux). O pacote appliance do MeiMei inclui um assistente de configuração que faz a configuração por si.

  1. Instale o Docker Desktop (Windows, macOS) ou o Docker Engine com Compose v2 (Linux), inicie-o e aguarde até indicar que está em execução.
  2. Transfira o pacote appliance do MeiMei a partir da página de suporte, descompacte-o e abra um terminal na respetiva pasta.
  3. Execute ./setup.sh (macOS, Linux) ou .\setup.ps1 (Windows PowerShell). O assistente de configuração pede o fornecedor de conversa e a respetiva chave, uma chave de reconhecimento de voz, funcionalidades opcionais e uma palavra-passe para o painel de controlo, e depois inicia o assistente com docker compose up -d.
  4. Abra o painel de controlo em http://localhost:8100/phone-assistant-v2/ e inicie sessão como admin com a palavra-passe escolhida. Mais tarde, docker compose down e docker compose up -d na mesma pasta param e iniciam o assistente; execute novamente o assistente de configuração para mudar de fornecedores ou de chaves.

2. Ligar e posicionar o dispositivo

Existem dois modelos. O modelo USB é uma placa com o ecrã; liga-se ao seu computador por cabo e não tem Wi-Fi. O modelo Wi-Fi tem a mesma placa principal com o ecrã mais um segundo módulo Bluetooth, e liga-se ao seu Wi-Fi. Coloque qualquer um deles dentro de um alcance Bluetooth fiável do telemóvel em nome do qual vai atender.

  1. Ligue o dispositivo com o cabo USB de dados fornecido; no modelo Wi-Fi, use a porta USB da placa principal, a que tem o ecrã. Os cabos apenas de carregamento não funcionam.
  2. Aguarde pelo ecrã de arranque: mostra MEIMEI, PHONE ASSISTANT e um código de 12 caracteres. Esse código é o ID do seu dispositivo; a etiqueta imprime-o depois de MM-.
  3. Veja a segunda linha do ecrã: LINK:USB-SERIAL indica um modelo USB, que comunica com o seu computador através do cabo; WIFI:... indica um modelo Wi-Fi, que comunica com o seu computador através da sua rede Wi-Fi.

3. Ligar o dispositivo ao assistente

Um modelo USB chega ao assistente através do cabo; um modelo Wi-Fi chega através da sua rede Wi-Fi, depois de uma configuração única no MeiMei Firmware Updater.

  1. Modelo USB: mantenha-o ligado ao computador que executa o assistente e inicie o pequeno programa de reencaminhamento USB, tal como o assistente de configuração indica no fim (o Docker Desktop não consegue passar dispositivos USB para os contentores). Só um programa de cada vez pode usar a porta USB do dispositivo.
  2. Modelo Wi-Fi: abra o MeiMei Firmware Updater, prima Scan for devices, instale uma atualização se for proposta e depois use o respetivo passo de Wi-Fi para introduzir o nome e a palavra-passe da sua rede Wi-Fi. O dispositivo precisa de uma rede de 2,4 GHz; o endereço do assistente é preenchido por si. Em alternativa, ligue-se à rede de configuração mostrada no ecrã do dispositivo com a palavra-passe indicada por baixo e abra http://192.168.4.1.
  3. Quando a ligação funciona, o ecrã do dispositivo mostra BACKEND:CONNECTED e o dispositivo aparece na página Devices do painel de controlo.

4. Emparelhar o telemóvel e fazer uma chamada de teste

O dispositivo emparelha com o telemóvel como um kit mãos-livres Bluetooth. O telemóvel mantém o seu cartão SIM e continua na rede móvel real.

  1. Um dispositivo novo fica pronto para emparelhar assim que é ligado. Para emparelhar mais tarde, mantenha o botão do dispositivo premido durante 3 a 8 segundos e depois solte-o; o emparelhamento fica aberto durante 90 segundos. Isto funciona nos dois modelos. Manter o botão premido durante mais de 8 segundos apaga as definições de Wi-Fi, o endereço do assistente e todos os emparelhamentos com telemóveis: o ecrã mostra ERASING..., depois ERASED, BT CLEARED, e o dispositivo reinicia. Uma pressão curta atende uma chamada a tocar (quando o assistente está ligado) ou desliga, também nos dois modelos.
  2. No telemóvel, escolha MeiMei Phone Assistant na lista Bluetooth, confirme o emparelhamento e permita o acesso aos contactos e às mensagens.
  3. A partir de outro telemóvel, ligue para o telemóvel emparelhado. O assistente atende (com a divulgação de IA ativada, começa por dizer que é um assistente de IA), e a chamada e a respetiva transcrição aparecem no painel de controlo.

5. Ajustar o assistente no painel de controlo

Cada dispositivo tem o seu próprio espaço de trabalho no painel de controlo, pelo que cada linha telefónica pode ter o seu próprio agente, voz, modelos e política de resposta.

  1. No separador General, ative o assistente, escolha a política de atendimento automático e o idioma preferido e defina a saudação.
  2. Nos separadores Agent, STT e TTS, escolha o agente e o fornecedor de voz, o modelo e a voz desta linha e use "Test provider" para confirmar que as credenciais funcionam.
  3. No separador Models, escolha o modelo de conversa e, se quiser, ative a voz em tempo real (pré-visualização, desativada por predefinição); o separador também mostra uma estimativa de custos para este dispositivo.
  4. Defina Working Hours se o assistente só deve atender em certos horários e gira os contactos, o registo de chamadas, a resposta automática a SMS e as listas de permitidos/bloqueados a partir da navegação superior.

6. Tenha os seus dados à mão para o apoio

O apoio é feito por e-mail. Alguns dados permitem-nos ajudá-lo logo na primeira resposta.

  1. Tenha à mão o ID da encomenda (apresentado na página Conta) e o ID do dispositivo (MM- mais 12 caracteres, na etiqueta e no MeiMei Firmware Updater).
  2. Anote o modelo do telemóvel e a versão do respetivo sistema operativo, bem como o que o ecrã do dispositivo mostrava quando o problema ocorreu.
  3. Consulte primeiro a lista de resolução de problemas abaixo; se não ajudar, escreva ao apoio a partir da página de Suporte.

7. Atualizações de firmware

As atualizações de firmware são gratuitas. Instalam-se apenas através do cabo USB, com a aplicação de ambiente de trabalho MeiMei Firmware Updater, versão 0.2.0 ou posterior, nunca por Wi-Fi nem pela internet. O dispositivo verifica se cada atualização é genuína antes de a instalar.

  1. Instale o MeiMei Firmware Updater (macOS ou Windows) apenas a partir da página de Suporte. Se o computador avisar que a aplicação está danificada ou é de um programador não identificado, não contorne o aviso; contacte o apoio.
  2. Ligue o dispositivo com o respetivo cabo USB de dados (modelo Wi-Fi: à placa principal, a que tem o ecrã). Num modelo USB, pare primeiro o programa de reencaminhamento USB. Prima Scan for devices e depois Install update, e mantenha o cabo ligado até a aplicação mostrar o resultado. Nunca desligue o dispositivo nem deixe o computador entrar em suspensão durante uma atualização; se for interrompida, o dispositivo fica à espera em RECOVERY MODE e basta executar a atualização novamente.
  3. Bom saber: não há limite de chamadas. O dispositivo não conta chamadas e nunca exige uma atualização após um certo número de chamadas; é você quem decide quando atualizar. Se o ecrã mostrar UPDATE REQUIRED, o dispositivo não conseguiu abrir o seu armazenamento protegido de definições e reinicia em RECOVERY MODE: instale a atualização e contacte o apoio se voltar a acontecer.
  4. O atualizador precisa de uma ligação à internet no seu computador para transferir a atualização feita para o seu dispositivo. Não use outras ferramentas de gravação: um dispositivo protegido recusa-as.

Pontos de verificação para resolução de problemas

  • O dispositivo nunca aparece no painel de controlo: use um cabo USB de dados, não um apenas de carregamento. Modelo USB: verifique se está a correr exatamente um programa de reencaminhamento USB. Modelo Wi-Fi: repita o passo de Wi-Fi do MeiMei Firmware Updater (apenas redes de 2,4 GHz).
  • O ecrã mostra BACKEND:CONNECTING ou RETRY: verifique se o computador está ligado, se o Docker está a correr e se o assistente está iniciado (docker compose ps na pasta appliance) e depois verifique o reencaminhamento USB (modelo USB) ou as definições de Wi-Fi (modelo Wi-Fi).
  • O emparelhamento do telemóvel falha: remova as entradas antigas MeiMei Phone Assistant da lista Bluetooth do telemóvel e depois mantenha o botão do dispositivo premido durante 3 a 8 segundos e solte-o para abrir novamente o emparelhamento (ambos os modelos).
  • As chamadas ligam, mas o assistente não ouve quem liga: falta uma chave de reconhecimento de voz ou está errada. Execute novamente o assistente de configuração ou use "Test provider" nos separadores STT e TTS.
  • O ecrã mostra UPDATE REQUIRED ou RECOVERY MODE: instale a atualização com o MeiMei Firmware Updater (secção 7).
  • As respostas parecem erradas ou genéricas: reveja a seleção do agente e os prompts por dispositivo no separador Agent.

Quando contactar o apoio

Se os pontos acima não resolverem o problema, escreva ao apoio por e-mail (o endereço está na página de Suporte) com o ID da encomenda, o ID do dispositivo, o modelo do telemóvel, o passo que falhou e o que o ecrã do dispositivo mostrava.

Suporte e garantia