Testar e ativar um modelo

Um modelo novo não pode ser enviado até passar por dois controles: um teste bem-sucedido e uma ativação explícita. Este artigo explica ambos, descreve o que um teste com falha faz (mais do que você poderia esperar) e explica o bloqueio de edição de modelos ativos.

Antes de começar

Você precisa de um modelo salvo; consulte Criar um modelo. Seu Status do modelo deve indicar Teste pendente.
Se o modelo usa campos de mesclagem, tenha em mãos um ID de registro do Objeto aplicável: o teste mescla dados de um registro real. Consulte Usar campos de mesclagem.
Atualizou de uma versão anterior? A página do modelo pode mostrar dois grupos de ações semelhantes, por exemplo Testar modelo e Testar modelo Connect (Obsoleto). Use sempre as que não têm "(Obsoleto)": Testar modelo, Ativar modelo e Desativar modelo. As equivalentes obsoletas são versões anteriores mantidas para continuidade.

Etapa 1: execute Testar modelo

Abra o registro do modelo.
Clique na ação Testar modelo.
Se Campo(s) de mesclagem estiver marcado, você deve fornecer um registro para realizar o teste. O texto na tela diz: Forneça um ID de registro de 18 caracteres do objeto aplicável para testar o modelo. Cole um ID de registro do objeto aplicável (copie-o da URL do registro).
Execute o teste.

Resultado esperado (sucesso): aparece Teste de modelo concluído com sucesso, o campo Data/hora de teste do modelo gerenciado pelo sistema é preenchido com a data e a hora atuais, e Status do modelo muda para Ativação pendente.

Diálogo de teste de Modelo Connect com a observação de que somente modelos testados e ativos podem ser usados para mensagens, e botões para executar o teste e concluir

A ação Testar modelo abre este diálogo: execute o teste aqui e confira se aparece Teste de modelo concluído com sucesso. Para um modelo com campos de mesclagem, tenha em mãos um ID de registro do objeto aplicável.

Se o teste falhar, você verá O teste do modelo falhou. junto com o motivo (por exemplo Os parâmetros de entrada fornecidos são inválidos. quando o ID de registro não corresponde ao objeto aplicável). Corrija o modelo ou os dados do teste e execute novamente.

Um teste com falha não apenas informa um erro. Se o modelo já havia passado em um teste, um novo teste com falha apaga a data/hora de teste E desativa o modelo imediatamente. Um modelo em uso que falha em um novo teste fica indisponível na hora: desaparece dos seletores dos agentes até passar em outro teste e ser reativado. Isso é intencional: um modelo que não pode mais ser gerado não deve continuar sendo enviado.

Etapa 2: ative o modelo

No modelo testado, clique na ação Ativar modelo.

Resultado esperado: aparece Modelo de conexão ativado com sucesso. e Status do modelo muda para Ativo. O modelo passa a aparecer no seletor do Feed Connect e nas mensagens em massa.

Notificação verde de sucesso confirmando que o Modelo Connect foi ativado com sucesso

A confirmação que você deve procurar: Modelo de conexão ativado com sucesso. Após a notificação, Status do modelo indica Ativo no registro e o modelo começa a aparecer no seletor do feed.

A ativação fica bloqueada até haver um teste bem-sucedido registrado:

Marcar manualmente Ativo em um modelo não testado impede salvar e mostra o erro de validação: Somente modelos testados podem ser marcados como Ativos. Para testar o modelo, use o botão "Testar modelo" no registro.
Executar Ativar modelo em um modelo não testado mostra: O modelo deve ser testado antes da ativação.
Executá-la em um modelo que já está ativo mostra: O modelo já está ativo.

Você não pode editar um modelo ativo

Um modelo ativo está bloqueado. Qualquer alteração em qualquer campo é rejeitada com:

Somente modelos inativos podem ser atualizados. Use o botão "Desativar modelo" para desativar o modelo antes de fazer alterações.

Portanto, o ciclo para alterar um modelo em uso é:

Desativar modelo → aparece Modelo de conexão desativado com sucesso. e o status volta para Ativação pendente. (Se executada em um modelo inativo, aparece O modelo Connect já está inativo.)
Faça as alterações e salve.
Execute novamente Testar modelo; consulte a regra abaixo.
Ativar modelo.

Diálogo de erro ao tentar salvar alterações em um modelo ativo: somente modelos inativos podem ser atualizados e é necessário desativar o modelo antes de alterá-lo; abaixo aparecem Cancelar e Salvar

Qualquer tentativa de salvar alterações em um modelo ativo é rejeitada com esse erro. Clique em Cancelar, execute Desativar modelo e só então faça a alteração.

Teste novamente após cada alteração. Editar um modelo desativado não apaga sua marca de teste anterior, então tecnicamente você poderia reativá-lo sem testar, mas aquele teste comprovou o corpo anterior, não sua alteração. Um erro de digitação em um campo de mesclagem só seria descoberto diante do cliente (ou faria o envio falhar). Execute Testar modelo obrigatoriamente após cada alteração.

Enquanto o modelo estiver desativado, os agentes não poderão selecioná-lo e os envios automatizados que o referenciem falharão. Programe as alterações fora dos períodos de maior atividade de mensagens.

Solução de problemas

Sintoma	Causa	Correção
`O modelo deve ser testado antes da ativação.`	Não há teste bem-sucedido registrado	Execute primeiro Testar modelo
`O teste do modelo falhou.` + `Os parâmetros de entrada fornecidos são inválidos.`	O ID de registro está ausente ou pertence a outro objeto em um modelo com mesclagem	Teste com um ID de registro de 18 caracteres do objeto aplicável
O modelo mostra de repente Teste pendente e está inativo	Um novo teste falhou: a marca foi apagada e o modelo foi desativado	Corrija o corpo (provavelmente um campo foi renomeado ou excluído), teste novamente e reative
`Somente modelos inativos podem ser atualizados. ...` ao salvar alterações	O modelo está ativo	Desativar modelo, editar, testar novamente, Ativar modelo
O teste foi bem-sucedido, mas o cliente recebeu texto `{{...}}` sem substituição	Campo(s) de mesclagem desmarcado: o teste o validou como texto simples	Consulte o erro dos campos de mesclagem

Perguntas frequentes

O teste chama o gerador do modelo. Se a mesclagem estiver ativada, extrai os campos, consulta o registro, substitui os valores e aplica a formatação. Uma falha nesse processamento faz o teste falhar. Ele não valida a entrega pelo provedor nem garante que os dados continuem válidos. Para verificar o processo completo, envie o modelo ativado para o seu próprio número.

Não. O teste gera o modelo apenas dentro do Salesforce; nada é entregue a um telefone. Para uma verificação real de ponta a ponta, envie o modelo ativado para seu próprio número pelo feed.

Sua organização foi atualizada para a versão 1.93, que substituiu essas ações por novas versões com os mesmos nomes e acrescentou "(Obsoleto)" às anteriores. Ambas ainda funcionam, mas use as que não estão obsoletas; o administrador pode remover as ações obsoletas do layout de página.

Qualquer pessoa com acesso de edição ao registro do modelo: as ações respeitam as permissões normais do objeto. Consulte Dar acesso à sua equipe.

Próximos passos

Enviar sua primeira mensagem: use o modelo recém-ativado pelo Feed Connect.
Visão geral das mensagens em massa: envie para uma lista inteira.
Usar campos de mesclagem: se o teste falhou pela sintaxe de mesclagem.