Marcadores de posición
17 min
Creado por Rafael Frigotto en 23/08/2017 10:30
Actualizado por Maria Malheiros en 21/10/2024 18:03
Los marcadores de posición son variables que se pueden utilizar para personalizar el contenido de algunas funcionalidades de Movidesk. Puedes utilizar estas variables en disparadores, macros, envío de correos electrónicos, chat y contratos de horas.
El uso de marcadores de posición es esencial cuando se trata de personalización automática de mensajes estándar. Puedes combinarlas de diversas maneras dentro de un mismo texto, de forma que el mensaje se adapte a diferentes situaciones y sea enriquecido con información específica.

Cómo utilizar los marcadores de posición - ejemplo
Al enviar el mismo correo electrónico a varios clientes sin personalizar su contenido, el mensaje recibido se vuelve muy genérico, además de limitar tu comunicación con el cliente. 
En el siguiente ejemplo, considera la creación de un disparador que tenga como acción el envío de un correo electrónico.

01-gatilho-com-acao-de-email.png


Con el uso de los marcadores de posición, con el mismo disparador ahora es posible enviar un texto más completo. Con ellos, puedes extraer información del sistema directamente al texto que se enviará.

02-texto-mais-completo-informacoes-do-sistema.png


El mensaje recibido por el destinatario llegará con un texto estándar, pero con información personalizada. Esto genera un mayor detalle de la información, así como un enfoque más personal, haciendo la lectura más agradable.
Observa que la información destacada en el correo electrónico se insertó a partir del uso de las variables dinámicas.

03-teste-email-recebido-pelo-gatilho.png

Para incluir estas variables dinámicas, solo tienes que escribir la llave { y el sistema mostrará la relación con todos los marcadores de posición que estén disponibles para tu aplicación actual.
Puedes buscar una variable simplemente abriendo la llave ( { ) y escribiendo la información asignada a ella. Por ejemplo, es posible buscar el placeholder "ticket.id" escribiendo "Número del ticket" después de la llave.

04-buscar-placeholders.png

Atención: Es esencial utilizar el placeholder {email.movidesk.info} en los disparadores de envío de correo electrónico, ya que relaciona el ticket con el correo enviado.

Uno de los principales impactos que tenemos es que el uso de este placeholder permite al sistema identificar la respuesta del cliente por correo electrónico, y así se incluye como acción en el ticket de origen.

Otro impacto del uso del mismo es que el delimitador de texto {text.import.delimiter} solo funciona si está incluido en el cuerpo del mensaje; sin el delimitador, el historial completo del correo se genera en el ticket, lo que puede generar acumulación indebida de información y problemas en el envío de correos electrónicos por el proveedor debido al tamaño total del mensaje.



Conoce más en "¿Cuándo debo aplicar el placeholder: email.movidesk.info?"

Consejo: Algunos marcadores de posición están disponibles solo en disparadores destinados a aplicaciones diferentes (para tickets, para correos electrónicos o para base de conocimiento). En general, estas variables se pueden identificar por el prefijo (ticket, email o kb).
La hoja con los marcadores de posición disponibles actualmente en Movidesk:

PLACEHOLDER INFORMAÇÃO ATRIBUÍDA
current.date Data e hora atual.
signedInUser.accessprofile Perfil de acesso do agente ou cliente logado.
signedInUser.supervisor Superior do agente ou cliente logado.
signedInUser.city Cidade do agente ou cliente logado.
signedInUser.contact Telefone do agente ou cliente logado.
signedInUser.contact.all Todos os contatos do agente ou cliente logado.
signedInUser.country País do agente ou cliente logado.
signedInUser.email E-mail do agente ou cliente logado.
signedInUser.email.all Todos os e-mails do agente ou cliente logado.
signedInUser.organization Organização do agente ou cliente logado.
signedInUser.name Nome do agente ou cliente logado.
signedInUser.profileType Se o usuário logado é agente ou cliente.
signedInUser.type Se o usuário logado é empresa, pessoa ou departamento.
signedInUser.role Cargo atual do usuário do ticket.
signedInUser.state Estado do agente ou cliente logado.
signedInUser.team Equipe do agente logado.
custom Campo adicional.
emailaccount.brand Campo marca da conta de e-mail pela qual a mensagem está sendo importada ou enviada.
email.message.attachments Anexos da mensagem de e-mail.
email.message.content Descrição da mensagem de e-mail.
email.message.from Remetente da mensagem de e-mail.
email.message.subject Assunto da mensagem de e-mail.
email.message.summary Mensagem de e-mail formatada e com arquivos anexados.
email.movidesk.info Informação do ticket, ação ou mensagem de origem (Para retorno ou resposta do e-mail).
greeting Cumprimento (Bom dia/tarde/noite) conforme o horário atual.
kb.article.approvalOrRejection.by Nome do aprovador ou reprovador do artigo.
kb.article.approvalOrRejection.date Data em que o artigo foi aprovado ou reprovado.
kb.article.suggestedBy Nome do usuário que candidatou o artigo.
kb.article.content Texto simples do conteúdo do artigo.
kb.article.creationDate Data de criação do artigo.
kb.article.formattedContent Texto formatado do conteúdo do artigo.
kb.article.subject Assunto do artigo.
kb.article.summary Resumo do artigo.
kb.article.ticketNumber Número do ticket associado ao artigo.
kb.article.ticketSubject Assunto do ticket associado ao artigo.
kb.article.createdBy Nome do usuário que criou o artigo.
tenant.name Nome fantasia da empresa.
tenant.url URL principal para acesso ao site de atendimento da empresa.
text.importDelimiter Delimitador do texto do e-mail. Somente o que estiver acima dessa linha é que será importado.
text.importDelimiter.multilanguage Delimitador do texto do e-mail em todos os idiomas.
ticket.acceptSolutionPrompt Bloco com o componente para que o cliente aceite ou não a solução no ticket.
ticket.note.count Quantidade de ações do ticket.
ticket.approval.prompt Bloco com o componente para aprovação do ticket.
ticket.approval.summary Resumo de quem aprovou, reprovou o ticket, data e comentários.
ticket.asset.brand Marca do(s) ativo(s) do ticket.
ticket.asset.category.full Categoria completa do(s) ativo(s) do ticket, delimitada pelo separador " » ".
ticket.asset.category.firstLevel Categoria (1º Nível) do(s) ativo(s) do ticket.
ticket.asset.category.secondLevel Categoria (2º Nível) do(s) ativo(s) do ticket.
ticket.asset.category.thirdLevel Categoria (3º Nível) do(s) ativo(s) do ticket.
ticket.asset.cost Custo do(s) ativo(s) do ticket.
ticket.asset.label Etiqueta do(s) ativo(s) do ticket.
ticket.asset.location Localização do(s) ativo(s) do ticket.
ticket.asset.manufacturer Fabricante do(s) ativo(s) do ticket.
ticket.asset.model Modelo do(s) ativo(s) do ticket.
ticket.asset.name Nome do(s) ativo(s) do ticket.
ticket.asset.purchaseDate Data de compra do(s) ativo(s) do ticket.
ticket.asset.serialNumber Número de série do(s) ativo(s) do ticket.
ticket.asset.status Status do(s) ativo(s) do ticket.
ticket.asset.warrantyDate Data de garantia do(s) ativo(s) do ticket.
ticket.category Categoria do ticket.
ticket.cc Cc do ticket.
ticket.custom Campo adicional.
ticket.requester.accessProfile Perfil de acesso do cliente do ticket.
ticket.requester.supervisor Superior do cliente do ticket.
ticket.requester.city Cidade do cliente do ticket.
ticket.requester.contact Contato do cliente do ticket.
ticket.requester.contact.all Todos os contatos do cliente do ticket.
ticket.requester.country País do cliente do ticket.
ticket.requester.email E-mail do cliente do ticket.
ticket.requester.email.all Todos os e-mails do cliente do ticket.
ticket.requester.organization Organização do cliente do ticket.
ticket.requester.organization.supervisor Superior hierárquico da organização do cliente do ticket.
ticket.requester.organization.contact Contato principal da organização do cliente do ticket.
ticket.requester.organization.contact.all Todos os contatos da organização do cliente do ticket.
ticket.requester.organization.email E-mail principal da organização do cliente do ticket.
ticket.requester.organization.email.all Todos os e-mails da organização do cliente do ticket.
ticket.requester.organization.role Cargo hierárquico da organização do cliente do ticket.
ticket.requester Nome do cliente do ticket.
ticket.requester.profileType Se o cliente do ticket é agente ou cliente.
ticket.requester.type Se o cliente do ticket é pessoa, empresa ou departamento.
ticket.requester.role Cargo do cliente do ticket.
ticket.requester.state Estado do cliente do ticket.
ticket.closeDate Data de conclusão do ticket.
ticket.firstNote.attachments Arquivos anexados da primeira ação pública do ticket.
ticket.firstNote.date Data de inclusão da primeira ação do ticket.
ticket.firstNote.content Descrição da primeira ação do ticket.
ticket.firstNote.creator.accessProfile Perfil de acesso do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.supervisor Superior do gerador que incluiu a primeira ação do ticket.
ticket.firstNote.city Cidade do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.contact Contato do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.contact.all Todos os contatos do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.country País do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.email E-mail do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.email.all Todos os e-mails do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.name Nome do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.profileType Se o usuário que incluiu ou editou a primeira ação é agente ou cliente.
ticket.firstNote.creator.type Se o usuário que incluiu ou editou a primeira ação é pessoa, empresa, ou departamento.
ticket.firstNote.creator.role Cargo do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.state Estado do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.team Equipe(s) do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.creator.organization Organização do usuário que incluiu a primeira ação do ticket.
ticket.firstNote.number Número da primeira ação do ticket.
ticket.firstNote.recipientSupportEmail Caixa de e-mail onde foi recebida a primeira ação do ticket.
ticket.firstNote.recipientSupportEmail.organization Nome da organização responsável pela caixa de e-mail onde foi recebida a primeira ação.
ticket.requesterSupportEmail Caixa de e-mail de onde veio a abertura do ticket.
ticket.requesterSupportEmail.organization Nome da organização responsável pela caixa de e-mail de onde veio a abertura do ticket.
ticket.firstNote.supportEmail Caixa de e-mail para qual foi enviada a primeira ação do ticket.
ticket.firstNote.supportEmail.organization Nome da organização responsável pela caixa de e-mail onde foi enviada a primeira ação.
ticket.id ID numérico do ticket.
ticket.idEncrypted ID criptografado do ticket.
ticket.lastNote.attachments Arquivos anexados na última ação pública do ticket.
ticket.lastNote.date Data da última ação do ticket.
ticket.lastNote.content Descrição da última ação do ticket.
ticket.lastNote.creator.accessProfile Perfil de acesso do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.supervisor Supervisor do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.city Cidade do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.contact Contato do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.contact.all Todos os contatos do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.country País do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.email E-mail do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.email.all Todos os e-mails do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.name Nome do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.profileType Se o usuário que incluiu a última ação é agente ou cliente.
ticket.lastNote.creator.type Se o usuário que incluiu a última ação é pessoa, empresa, ou departamento.
ticket.lastNote.creator.role Cargo do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.state Estado do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.team Equipe(s) do usuário que incluiu a última ação do ticket.
ticket.lastNote.creator.organization Organização do usuário que incluiu a última ação do ticket.
ticket.lastNote.number Número da última ação do ticket.
ticket.lastNote.recipientSupportEmail Caixa de e-mail onde foi recebida a última ação do ticket.
ticket.lastNote.recipientSupportEmail.organization Nome da organização responsável pela caixa de e-mail onde foi recebida a última ação.
 

 
¿Te ha útil este artículo?
Vistos recientemente