Gmail
Permite que o agente busque, leia, envie, mova e exclua e-mails no Gmail. Requer uma Conexão Google Gmail configurada no workspace.
Ações disponíveis
Ao adicionar esta ferramenta, selecione quais operações o agente tem permissão de executar.
Buscar e-mails
Pesquisa e-mails na caixa de entrada com base em uma consulta no formato do Gmail.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| Consulta | Sim | — | Critério de pesquisa no formato do Gmail (ex: from:joao@exemplo.com, subject:reunião, is:unread, has:attachment) |
| Máximo de resultados | Não | 10 | Número máximo de e-mails a retornar |
| Incluir spam e lixeira | Não | false | Se true, inclui e-mails das pastas spam e lixeira nos resultados |
Obter e-mail
Retorna os detalhes de um e-mail específico pelo seu ID.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do e-mail | Sim | — | ID único do e-mail a obter |
| Formato | Não | full | Nível de detalhe da resposta: full (completo com corpo), metadata (apenas cabeçalhos), minimal ou raw |
Enviar e-mail
Envia um e-mail pela conta Gmail conectada.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| Para | Sim | — | Lista de endereços de e-mail dos destinatários principais |
| CC | Não | — | Lista de endereços em cópia |
| BCC | Não | — | Lista de endereços em cópia oculta |
| Assunto | Sim | — | Assunto do e-mail |
| Corpo | Sim | — | Conteúdo do e-mail |
| Corpo em HTML | Não | false | Se true, interpreta o corpo como HTML. Se false, envia como texto simples |
| Responder para | Não | — | Endereço de e-mail para resposta |
| ID da conversa | Não | — | ID da thread para enviar o e-mail como resposta em uma conversa existente |
Mover e-mail
Move um e-mail para uma pasta diferente adicionando ou removendo labels do Gmail.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do e-mail | Sim | — | ID único do e-mail a mover |
| Labels a adicionar | Não | — | Lista de IDs de labels a adicionar (ex: INBOX, STARRED, Label_123) |
| Labels a remover | Não | — | Lista de IDs de labels a remover (ex: INBOX, UNREAD) |
Pelo menos um dos campos "Labels a adicionar" ou "Labels a remover" deve ser informado.
Excluir e-mail
Remove um e-mail, com opção de enviar para a lixeira ou excluir permanentemente.
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
| ID do e-mail | Sim | — | ID único do e-mail a remover |
| Mover para lixeira | Não | true | Se true, move o e-mail para a lixeira (recuperável). Se false, exclui permanentemente |