Coze no WeChat: Trazendo o robô Coze (botão) para o WeChat

🚀 Convite para experimentar: o primeiro software de programação inteligente AI IDE da China Download da versão chinesa do TraeO DeepSeek-R1 e o Doubao-pro estão disponíveis em uma base ilimitada!

Introdução geral

Coze on WeChat é um projeto de código aberto criado para ajudar os usuários a integrar perfeitamente os bots de IA da plataforma Coze ao WeChat. Ele se baseia no chatgpt-on-wechat e no dify-on-wechat e oferece suporte a bate-papo de texto, reconhecimento e resposta de voz, funcionalidade de plug-in e envio de imagens e links. O projeto usa o protocolo do iPad do Gewechat para fazer login no WeChat, que é mais estável do que o itchat tradicional. Os usuários precisam criar bots na plataforma Coze e, por meio de uma configuração simples, podem obter uma interação inteligente no WeChat. O projeto oferece uma interface de gerenciamento baseada na Web para facilitar o ajuste das configurações. Desde março de 2025, ele está sendo seguido por desenvolvedores no GitHub e é adequado para indivíduos ou equipes criarem assistentes inteligentes para o WeChat.

Coze no WeChat: Conectando o bot Coze (botão) ao WeChat-1

Configuração do COZE

Configuração de back-end do Coze no WeChat

Lista de funções

bate-papo por textoBate-papos privados e em grupo são suportados, e o bot se lembra do contexto da conversa para fornecer respostas coerentes.
interação por vozReconhece a entrada de voz em 20 segundos e oferece suporte a respostas de voz.
Suporte a plug-insFuncionalidade do plug-in Docking Coze para transformar cartões de plug-in em links do WeChat.
entrega de multimídiaCapacidade de enviar imagens, links e outros conteúdos para aprimorar a experiência interativa.
Interface de gerenciamento da WebAjuste dos parâmetros do robô por meio da página da Web sem modificar o código.
função de base de conhecimentoCarregar arquivos ou conteúdo da Web e permitir que o robô responda a perguntas com base nesses dados.

Usando a Ajuda

Processo de instalação

O uso do Coze no WeChat requer a preparação do ambiente e a conclusão da implantação. Veja a seguir as etapas detalhadas:

1. trabalho preparatório

Inscreva-se em uma conta CozeVisite o site da Coze, registre-se e faça login. Clique em "Create Robot" para configurar seu robô.
Obtendo a chave da APINa página "Personal Access Token" do Coze (link (em um site)) Gere o token e salve-o.
ferramenta de montagemGit para fazer download de código e Docker para executar serviços.
Selecione o método de implantaçãoSuporte para execução local, execução no servidor e implantação do Docker, basta escolher um.

2. fazer o download do projeto

Digite-o em um terminal ou na linha de comando:

git clone https://github.com/JC0v0/Coze-on-Wechat
cd Coze-on-Wechat

Isso fará o download do código do projeto e entrará no diretório.

3. ambiente de configuração

Implementação local ou em servidor

Criação de um ambiente virtual(Opcional, mas recomendado):

Use venv:

python3 -m venv Coze-on-Wechat
source Coze-on-Wechat/bin/activate # Windows com Coze-on-Wechat\Scripts\activate

Use conda:

conda create -n Coze-on-Wechat python=3.12
conda activate Coze-on-Wechat

Instalação de dependências::

pip3 install -r requirements.txt

Configurar o config.json::

cp config.json.example config.json

Abrir com um editor de texto config.jsonPreencha os campos-chave abaixo:

{
"coze_api_base": "https://api.coze.cn",
"coze_api_key": "Sua chave de API",
"coze_bot_id": "Seu ID de bot", // Obtenha-o no URL da página de desenvolvimento da Coze
"channel_type": "gewechat", "model": "coze": "coze_bot_id", // Do URL da página de desenvolvimento da Coze.

"single_chat_prefix": ["bot", "@bot"], // Termo de acionamento de chat privado
"group_chat_prefix": ["@bot"], // Palavra acionadora do chat em grupo
"group_name_white_list": ["ALL_GROUP"] // Grupos que permitem respostas de bots
}

Implementação do Docker

Puxando espelhos Gewechat::

docker pull registro.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine
docker tag registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine gewe

Criação de um catálogo de dados::

mkdir -p gewechat/data

Cópia de arquivos de configuração::

cp config-template.json config.json

Início dos serviços::

docker-compose up -d

4. ativação e login

operação local::

python3 app.py

operação do servidor::

nohup python3 app.py & tail -f nohup.out

Operação da interface da Web::

cd web
streamlit run Home.py

entrevistas http://localhost:8501A configuração é feita na página da Web.

Implementação do DockerVerificação do registro após a inicialização: Verifique o registro após a inicialização:

registros do docker -f coze-on-wechat

Faça login no WeChatUm link de código QR será exibido no registro, abra o link e faça a leitura com o WeChat para fazer login.

5. funções de teste

Depois de fazer login, envie uma mensagem para o teste de bot. Exemplo:

Bate-papo privado: digite "bot hello" ou "@bot hello".
Bate-papo em grupo: digite "@bot Today's Weather" no grupo da lista de permissões.

Função Fluxo de operação

bate-papo por texto

bate-papo privadoMensagem: Envie uma mensagem diretamente para o bot, por exemplo, "bot check weather", e ele responderá.
bate-papo em grupoAdicionar acionadores de perguntas com "@bot" em grupos permitidos, por exemplo, "@bot que horas chove amanhã".

interação por voz

enviar uma vozGravação de voz: grave sua voz em 20 segundos e envie-a para o robô, que a reconhecerá e responderá.
receber um discursoSe a resposta de voz estiver ativada (a ID do tom precisa ser definida em Coze), o robô responderá com voz.
Configuração de voz: em config.json Situado em:

"speech_recognition": true,
"text_to_voice": "coze", "coze_voice_id": "tone_id" // obtido da documentação do Coze
"coze_voice_id": "tone_id" // recuperado do documento Coze

Suporte a plug-ins

Adicionar plug-ins (por exemplo, consultas de notícias) para bots na plataforma Coze.
Envie um comando no WeChat (por exemplo, "verificar notícias") e o robô retornará o link do WeChat.
Exemplo: Envie "check the weather" e o link do clima será retornado.

entrega de multimídia

O robô pode enviar imagens ou links. Por exemplo, peça "Show me a picture of a cat" (Mostre-me a foto de um gato) e ele enviará uma foto.

Interface de gerenciamento da Web

Depois de iniciar a interface da Web, acesse a http://服务器IP:8501.
Modifique parâmetros como palavras de acionamento, lista branca de grupos etc. na interface sem editar o arquivo.

advertência

estabilidadeO protocolo do Gewechat para iPad é mais estável, mas é recomendável testá-lo com um número pequeno para evitar o risco do número principal.
Código de DependênciaA funcionalidade depende da plataforma Coze para garantir que a chave da API seja válida.
requisito de redeA implementação do servidor exige que as portas correspondentes (por exemplo, 2531, 2532, 9919) estejam abertas.

cenário do aplicativo

Assistente pessoal
Faça perguntas, obtenha informações ou realize tarefas, como verificar o clima ou fazer anotações no WeChat a qualquer momento.
Gerenciamento de bate-papo em grupo
Os robôs respondem automaticamente a perguntas comuns no grupo, reduzindo a carga sobre os administradores, o que é adequado para grupos de interesse ou de trabalho.
Ferramentas de aprendizado
Após o upload dos materiais de aprendizagem, o robô pode responder a perguntas relevantes e facilitar a revisão dos alunos.

QA

Preciso configurar a resposta de voz adicionalmente?
Sim, você precisa definir a ID de tom na plataforma Coze e definir a ID de tom na plataforma Coze. config.json Ative a opção de voz.
Ele suporta o envio de fotos?
o robô pode retornar imagens ou links com base na configuração do Coze.
Qual é a diferença entre a implantação do Docker e a implantação local?
O Docker é mais adequado para implantação de servidor com um clique e gerenciamento simples; a implantação local é adequada para desenvolvimento e depuração.