Conecta-seEntrar na plataforma

Gmail

Enviar, ler, pesquisar e mover mensagens do Gmail ou iniciar fluxos a partir de eventos da conta.

Integrações e ferramentasE-mailConexão: OAuth

O que faz

Integre o Gmail ao fluxo para enviar, ler, buscar e mover e-mails. Também pode ser usado no modo gatilho, para iniciar um fluxo quando chegar um novo e-mail.

Quando usar: Use quando o seu fluxo precisar enviar, ler, pesquisar e mover mensagens do Gmail ou iniciar fluxos a partir de eventos da conta.

Exemplo de situação: Enviar uma confirmação por e-mail ou tratar uma mensagem recebida.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Gmail ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Para configurar o gatilho

  1. Conecte a sua conta do Gmail com uma credencial OAuth
  2. Configure quais marcadores do Gmail monitorar (opcional)
  3. A plataforma vai verificar automaticamente se chegaram novos e-mails e iniciar o seu fluxo

Operações

OperaçãoO que faz
Enviar e-mailEnvia e-mail com o bloco Gmail.
Ler e-mailLê e-mail com o bloco Gmail.
Buscar e-mailsBusca e-mails com o bloco Gmail.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Enviar e-mail · Ler e-mail · Buscar e-mails
    Padrão:
    Enviar e-mail

  • Conta do Gmail

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • Conta do Gmail

    ObrigatórioEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

  • Conta representada

    E-mail do usuário a representar (para contas de serviço).

    Exemplo:
    cliente@exemplo.com

  • Para

    Obrigatório conforme a operação

    E-mail do destinatário.

    Aparece em:
    Enviar e-mail
    Exemplo:
    cliente@exemplo.com

  • Assunto

    Assunto do e-mail.

    Aparece em:
    Enviar e-mail
    Exemplo:
    Exemplo de atendimento

  • Corpo

    Obrigatório conforme a operação

    Informa o conteúdo enviado no corpo da requisição.

    Aparece em:
    Enviar e-mail
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Tipo de conteúdo

    Informa o conteúdo de texto que será enviado ou processado.

    Aparece em:
    Enviar e-mail
    Opções:
    Texto simples · HTML
    Padrão:
    Texto simples

  • Anexos

    Envie os arquivos a anexar.

    Aparece em:
    Enviar e-mail
    Exemplo:
    (selecione um arquivo de teste)

  • Anexos

    Em campos adicionais

    Referencie arquivos de blocos anteriores.

    Aparece em:
    Enviar e-mail

  • ID da conversa

    Em campos adicionais

    ID da conversa a responder (para manter tudo na mesma conversa).

    Aparece em:
    Enviar e-mail
    Exemplo:
    id-do-recurso

  • ID da mensagem a responder

    Em campos adicionais

    ID da mensagem no Gmail (não o Message-ID do RFC) - use o campo "id" dos resultados.

    Aparece em:
    Enviar e-mail
    Exemplo:
    id-do-recurso

  • Cc

    Em campos adicionais

    Destinatários em Cc (separados por vírgula).

    Aparece em:
    Enviar e-mail
    Exemplo:
    Destinatários em Cc (separados por vírgula)

  • Cco

    Em campos adicionais

    Destinatários em Cco (separados por vírgula).

    Aparece em:
    Enviar e-mail
    Exemplo:
    Destinatários em Cco (separados por vírgula)

  • Marcador

    Selecione o marcador/pasta do Gmail.

    Aparece em:
    Ler e-mail
    Exemplo:
    (escolha na lista do campo)

  • Marcador/pasta

    Em campos adicionais

    Informe o nome do marcador do Gmail (ex.: INBOX, SENT ou um marcador personalizado).

    Aparece em:
    Ler e-mail
    Exemplo:
    /documentos/exemplo.pdf

  • Somente não lidos

    Ativa ou desativa este comportamento.

    Aparece em:
    Ler e-mail
    Exemplo:
    false

  • Incluir anexos

    Informa ou seleciona o arquivo usado nesta operação.

    Aparece em:
    Ler e-mail
    Exemplo:
    false

  • ID da mensagem

    Em campos adicionais

    Ler um e-mail específico pelo ID (tem prioridade sobre o marcador/pasta).

    Aparece em:
    Ler e-mail
    Exemplo:
    id-do-recurso

  • Consulta de busca

    Obrigatório conforme a operação

    Informa a consulta usada para localizar ou transformar dados.

    Aparece em:
    Buscar e-mails
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Máximo de resultados

    Número máximo de resultados (padrão: 10).

    Aparece em:
    Buscar e-mails, Ler e-mail
    Exemplo:
    10

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <gmail.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<gmail.content>stringConteúdo da resposta.
<gmail.metadata>jsonMetadados do e-mail.
<gmail.attachments>file[]Lista de anexos do e-mail.
<gmail.email_id>stringID da mensagem no Gmail.
<gmail.thread_id>stringID da conversa no Gmail.
<gmail.subject>stringAssunto do e-mail.
<gmail.from>stringE-mail do remetente.
<gmail.to>stringE-mail do destinatário.
<gmail.cc>stringDestinatários em Cc (separados por vírgula).
<gmail.date>stringData do e-mail no formato ISO.
<gmail.body_text>stringCorpo do e-mail em texto simples.
<gmail.body_html>stringCorpo do e-mail em HTML.
<gmail.labels>stringMarcadores do e-mail (separados por vírgula).
<gmail.has_attachments>booleanIndica se o e-mail tem anexos.
<gmail.raw_email>jsonDados brutos completos do e-mail vindos da API do Gmail (se ativado).
<gmail.timestamp>stringData e hora do evento.

Exemplo de uso

Objetivo: Enviar uma confirmação por e-mail ou tratar uma mensagem recebida.

InícioGmailpróxima etapa
Operação
Enviar e-mail
Conta do Gmail
(escolha a conta conectada)
Conta representada
cliente@exemplo.com
Para
cliente@exemplo.com
Assunto
Exemplo de atendimento
Corpo
Olá! Sua solicitação foi processada com sucesso.

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <gmail.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados