Pular para conteúdo

ADD_LABEL - Adicionar Label ao Email

⚠️ FUNCIONALIDADE NÃO IMPLEMENTADA

STATUS: Esta funcionalidade ainda não está implementada no Gmail Executor.

O que seria este Node?

O ADD_LABEL seria o node para adicionar labels (etiquetas) aos emails do Gmail para organização e categorização.

Por que este Node deveria existir?

Labels permitem organização flexível e automação de categorização. Deveria existir para:

  1. Categorização automática: Organizar emails por tipo/projeto
  2. Workflows personalizados: Criar fluxos baseados em labels
  3. Organização visual: Identificar emails rapidamente
  4. Automação completa: Processar e categorizar automaticamente

Código sugerido para implementação:

private async addLabel(gmail: any, data: GmailNodeData): Promise<any> {
  const response = await gmail.users.messages.modify({
    userId: 'me',
    id: data.messageId,
    requestBody: {
      addLabelIds: [data.labelId]
    }
  });

  return {
    messageId: data.messageId,
    action: 'label_added',
    labelId: data.labelId,
    labelIds: response.data.labelIds
  };
}

Labels Padrão do Gmail

  • INBOX - Caixa de entrada
  • SENT - Enviados
  • DRAFT - Rascunhos
  • SPAM - Spam
  • TRASH - Lixeira
  • UNREAD - Não lido
  • STARRED - Com estrela
  • IMPORTANT - Importante

Casos de uso

  1. Categorizar cliente: "Adicionar label 'VIP' para clientes importantes"
  2. Organizar projeto: "Label 'Projeto X' em emails relacionados"
  3. Priorizar: "Adicionar 'URGENTE' para processamento rápido"
  4. Rastrear status: "Label 'Processado' após automação"

Parâmetros

Campo Tipo Obrigatório Descrição
oauth2 object Sim Credenciais OAuth2
operation string Sim Deveria ser "add_label"
messageId string Sim ID do email
labelId string Sim ID da label a adicionar

Exemplo de uso (quando implementado)

{
  "operation": "add_label",
  "messageId": "18f2b9c4d5e6a7f8",
  "labelId": "Label_123456789"
}

Como obter labelId

// Listar labels disponíveis
const labels = await gmail.users.labels.list({ userId: 'me' });

// Ou criar nova label
const newLabel = await gmail.users.labels.create({
  userId: 'me',
  requestBody: {
    name: 'Minha Label',
    labelListVisibility: 'labelShow',
    messageListVisibility: 'show'
  }
});

Próximo Node

REMOVE_LABEL - Remover label → GET_EMAIL_BY_ID - Verificar labels → SEARCH_EMAILS - Buscar por label