--- title: "FAQ Integrações — WhatsApp, Telegram, Discord, Calendário e Email" url: "https://openclaw.ia.br/faq/integracoes/" markdown_url: "https://openclaw.ia.br/faq/integracoes.MD" description: "Como conectar o OpenClaw com WhatsApp, Telegram, Discord, Google Calendar e automações de e-mail. Guia completo de integrações." date: "2026-02-01" author: "" --- # FAQ Integrações — WhatsApp, Telegram, Discord, Calendário e Email Como conectar o OpenClaw com WhatsApp, Telegram, Discord, Google Calendar e automações de e-mail. Guia completo de integrações. # FAQ Integrações Tudo sobre conectar o OpenClaw com mensageiros, calendário e e-mail. --- ## WhatsApp ### Como Conecto o WhatsApp? 1. Configure o canal WhatsApp no `config.yaml`: ```yaml whatsapp: enabled: true ``` 2. Inicie o gateway: ```bash openclaw gateway start ``` 3. Escaneie o QR code com seu WhatsApp ### Preciso de WhatsApp Business? **Não!** Funciona com WhatsApp pessoal normal. Usamos a biblioteca Baileys que simula o WhatsApp Web. ### Posso Usar em Grupos? **Sim!** Configure quais grupos responder: ```yaml whatsapp: groups: allowlist: - "Grupo Trabalho" - "Família" ``` ### Minha Conta Pode Ser Banida? **Risco baixo se usar responsavelmente:** - Evite spam/mensagens em massa - Não envie para contatos que não te conhecem - Use respostas naturais, não robóticas ### Posso Enviar Imagens/Arquivos? **Sim!** O agente pode enviar e receber: - Imagens - Documentos (PDF, DOC, etc.) - Áudios - Vídeos curtos Veja mais: [FAQ WhatsApp Completo](/faq/whatsapp/) --- ## Telegram ### Como Conecto o Telegram? 1. Crie um bot no [@BotFather](https://t.me/BotFather): - Envie `/newbot` - Escolha nome e username - Copie o token 2. Configure no `config.yaml`: ```yaml telegram: enabled: true token: "123456:ABC-DEF..." ``` 3. Reinicie o gateway ### Vantagens vs WhatsApp | Aspecto | Telegram | WhatsApp | |---------|----------|----------| | Setup | Mais fácil (API oficial) | Mais manual | | Risco de ban | Zero | Baixo | | Bots em grupos | Melhor suporte | Limitado | | Arquivos grandes | Até 2GB | Até 100MB | ### Posso Usar Bot Existente? **Sim!** Basta configurar o token do seu bot atual. ### Funciona em Grupos/Canais? **Sim!** Adicione o bot ao grupo e configure: ```yaml telegram: groups: enabled: true mention_only: true # Só responde se mencionado ``` --- ## Discord ### Como Conecto o Discord? 1. Crie um app no [Discord Developer Portal](https://discord.com/developers/applications) 2. Vá em "Bot" → "Add Bot" 3. Copie o token 4. Configure: ```yaml discord: enabled: true token: "seu-token-aqui" ``` 5. Convide o bot para seu servidor: - OAuth2 → URL Generator - Scopes: `bot`, `applications.commands` - Permissions: Read/Send Messages, etc. ### Posso Usar em Múltiplos Servidores? **Sim!** Um bot pode estar em vários servidores. Configure regras por servidor: ```yaml discord: servers: "123456789": # ID do servidor channels: - "bot-commands" - "general" ``` ### Funciona com Slash Commands? **Em desenvolvimento!** Atualmente responde a mensagens normais. Slash commands planejados para versões futuras. ### Posso Responder DMs? **Sim!** Ativado por padrão. Para desativar: ```yaml discord: dm: enabled: false ``` --- ## Google Calendar ### Como Conecto o Calendário? 1. Crie projeto no [Google Cloud Console](https://console.cloud.google.com) 2. Ative a Calendar API 3. Crie credenciais OAuth 2.0 4. Configure: ```yaml google: calendar: enabled: true credentials_file: "credentials.json" ``` 5. Autorize na primeira execução ### O Que o Agente Pode Fazer? - ✅ Ver próximos eventos - ✅ Criar novos eventos - ✅ Atualizar eventos existentes - ✅ Cancelar eventos - ✅ Verificar disponibilidade - ✅ Sugerir horários ### Exemplos de Uso ``` "Quais são meus compromissos amanhã?" "Agenda reunião com João para sexta às 15h" "Remarque a reunião de ontem para próxima semana" "Estou livre às 14h na terça?" ``` ### Funciona com Outlook/iCal? **Parcialmente.** Suporte nativo apenas para Google Calendar. Para outros: - Exporte/importe via .ics - Use integrações de terceiros (Zapier, n8n) --- ## E-mail ### Como Conecto o E-mail? **Opção 1: IMAP/SMTP (Gmail, Outlook, etc.)** ```yaml email: imap: host: "imap.gmail.com" port: 993 user: "seu@gmail.com" password: "senha-de-app" smtp: host: "smtp.gmail.com" port: 587 user: "seu@gmail.com" password: "senha-de-app" ``` **Nota:** Para Gmail, use [Senhas de App](https://myaccount.google.com/apppasswords), não sua senha normal. **Opção 2: API (Gmail API)** ```yaml google: gmail: enabled: true credentials_file: "credentials.json" ``` ### O Que o Agente Pode Fazer? - ✅ Ler e-mails não lidos - ✅ Buscar e-mails por assunto/remetente - ✅ Resumir e-mails longos - ✅ Redigir rascunhos - ✅ Enviar e-mails (com sua aprovação) - ✅ Marcar como lido/importante - ✅ Arquivar mensagens ### Exemplos de Uso ``` "Tenho e-mails importantes não lidos?" "Resuma os e-mails do João desta semana" "Redigir resposta para o último e-mail do cliente" "Envie e-mail para diego@email.com sobre a reunião" ``` ### É Seguro Dar Acesso ao E-mail? **Com ressalvas:** - Use conta separada para testes iniciais - Configure human-in-the-loop para envios - O agente não envia sem sua aprovação (padrão) - Revise rascunhos antes de enviar --- ## Outras Integrações ### Slack ```yaml slack: enabled: true bot_token: "xoxb-..." app_token: "xapp-..." ``` Funciona similar ao Discord, com suporte a canais e DMs. ### Notion ```yaml notion: enabled: true api_key: "secret_..." ``` Lê e escreve páginas, bancos de dados e blocos. ### GitHub ```yaml github: enabled: true token: "ghp_..." ``` Cria issues, PRs, comenta, busca em repos. ### APIs Customizadas Qualquer API pode ser integrada via Skills: ```javascript // skills/minha-api/SKILL.md // Define como usar sua API ``` --- ## Solução de Problemas ### WhatsApp: QR Code Não Aparece ```bash # Limpe sessão anterior rm -rf ~/.openclaw/whatsapp/ openclaw gateway restart ``` ### Telegram: Bot Não Responde 1. Verifique se o token está correto 2. Confirme que o bot está ativo no BotFather 3. Verifique logs: `openclaw logs` ### Calendar: Erro de Autorização 1. Delete `token.json` 2. Reautorize na próxima execução 3. Verifique escopos da API ### E-mail: Falha de Login Para Gmail: 1. Ative autenticação em 2 etapas 2. Gere senha de app 3. Use a senha de app, não a normal --- ## Próximas Perguntas - [FAQ WhatsApp (detalhado)](/faq/whatsapp/) - [FAQ Configuração](/faq/configuracao/) - [FAQ Técnico](/faq/tecnico/) - [FAQ Privacidade](/faq/privacidade/)