Conecta-seEntrar na plataforma

Criar versão do modelo · SendGrid

Criar versão do modelo usando a conexão SendGrid deste workspace.

Integrações e ferramentasE-mailConexão: Credencial protegida

O que faz

Criar versão do modelo usando a conexão SendGrid deste workspace.

Quando usar: Use quando o seu fluxo precisar Criar versão do modelo usando a conexão SendGrid deste workspace..

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

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Criar versão do modelo · SendGrid ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Revise a ação principal descrita no cartão do bloco.
  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.

Operações

OperaçãoO que faz
Criar versão do modeloCria versão do modelo com o bloco Criar versão do modelo · SendGrid.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Criar versão do modelo
    Padrão:
    Criar versão do modelo

  • Chave de API do SendGrid

    ObrigatórioDado protegido

    Usa a chave salva em Integrações → SendGrid.

    Padrão:
    Segredo protegido

  • ID do modelo

    Obrigatório conforme a operação

    ID do modelo.

    Aparece em:
    Criar versão do modelo
    Exemplo:
    id-do-recurso

  • Nome da versão

    Obrigatório conforme a operação

    Nome da versão.

    Aparece em:
    Criar versão do modelo
    Exemplo:
    Exemplo de atendimento

  • Assunto do modelo

    Obrigatório conforme a operação

    Assunto do e-mail.

    Aparece em:
    Criar versão do modelo
    Exemplo:
    Exemplo de atendimento

  • Conteúdo em HTML

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

    Aparece em:
    Criar versão do modelo
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Conteúdo em texto simples

    Em campos adicionais

    Conteúdo em texto simples.

    Aparece em:
    Criar versão do modelo
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Ativo

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Criar versão do modelo
    Opções:
    Sim · Não
    Padrão:
    Sim

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 <criarversaodomodelosendgrid.success>: 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
<criarversaodomodelosendgrid.success>booleanIndica se a operação foi concluída com sucesso.
<criarversaodomodelosendgrid.message>stringMensagem de status ou de sucesso.
<criarversaodomodelosendgrid.messageId>stringID da mensagem de e-mail (send_mail).
<criarversaodomodelosendgrid.to>stringE-mail do destinatário (send_mail).
<criarversaodomodelosendgrid.subject>stringAssunto do e-mail (send_mail, create_template_version).
<criarversaodomodelosendgrid.id>stringID do recurso.
<criarversaodomodelosendgrid.jobId>stringID da tarefa nas operações assíncronas.
<criarversaodomodelosendgrid.email>stringE-mail do contato.
<criarversaodomodelosendgrid.firstName>stringNome do contato.
<criarversaodomodelosendgrid.lastName>stringSobrenome do contato.
<criarversaodomodelosendgrid.createdAt>stringData e hora de criação.
<criarversaodomodelosendgrid.updatedAt>stringData e hora da última atualização.
<criarversaodomodelosendgrid.listIds>jsonLista de IDs das listas a que o contato pertence.
<criarversaodomodelosendgrid.customFields>jsonValores dos campos personalizados.
<criarversaodomodelosendgrid.contacts>jsonLista de contatos.
<criarversaodomodelosendgrid.contactCount>numberQuantidade de contatos.
<criarversaodomodelosendgrid.lists>jsonLista das listas de contatos.
<criarversaodomodelosendgrid.name>stringNome do recurso.
<criarversaodomodelosendgrid.templates>jsonLista de modelos.
<criarversaodomodelosendgrid.generation>stringGeração do modelo.
<criarversaodomodelosendgrid.versions>jsonLista de versões do modelo.
<criarversaodomodelosendgrid.nextPageToken>stringToken da próxima página de resultados (list_all_lists, list_templates).
<criarversaodomodelosendgrid.templateId>stringID do modelo.
<criarversaodomodelosendgrid.active>booleanIndica se a versão do modelo está ativa.
<criarversaodomodelosendgrid.htmlContent>stringConteúdo HTML.
<criarversaodomodelosendgrid.plainContent>stringConteúdo em texto simples.
<criarversaodomodelosendgrid.status>numberCódigo HTTP retornado pelo SendGrid. Use junto de body e data para conferir o resultado da operação.
<criarversaodomodelosendgrid.body>jsonResposta completa do SendGrid.
<criarversaodomodelosendgrid.data>jsonDados estruturados para outros blocos.

Exemplo de uso

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

InícioCriar versão do modelo · SendGridpróxima etapa
Operação
Criar versão do modelo
ID do modelo
id-do-recurso
Nome da versão
Exemplo de atendimento
Assunto do modelo
Exemplo de atendimento
Conteúdo em HTML
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 <criarversaodomodelosendgrid.success>. 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”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
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