Placeholders are variables that can be used to customize the content of some Movidesk functionalities. You can use these variables in triggers, macros, email sending, chat, and time contracts.
The use of placeholders is essential when it comes to automatic customization of standard messages. You can combine them in various ways within the same text, so that the message adapts to different situations and is enriched with specific information.
How to use placeholders - example
When sending the same email to multiple clients without customizing its content, the received message becomes very generic, limiting your communication with your client.
In the following example, consider creating a trigger that has the action of sending an email.
With the use of placeholders, with the same trigger it is now possible to send a more complete text. With them, you can extract information from the system directly into the text to be sent.
The message received by the recipient will come with a standard text, but with customized information. This creates greater detail in the information, as well as a more personal approach, making the reading more pleasant.
That the information will be highlighted in the email was inserted from the use of dynamic variables.
To include these dynamic variables, just type the bracket { and the system will display the list of all placeholders available for your current application.
You can search for a variable by simply opening the bracket ( { ) and typing the information assigned to it. For example, you can search for the placeholder "ticket.id" by typing "Ticket number" after the bracket.
Attention: It is essential to use the placeholder {email.movidesk.info} in email sending triggers, as it links the ticket to the email sent.
One of the main impacts is that using this placeholder allows the system to identify the client's response via email, and thus it is included as an action in the original ticket.
Another impact of using it is that the text delimiter {text.import.delimiter} only works if it is included in the body of the message; without the delimiter, the complete email history is generated in the ticket, which can lead to excessive information accumulation and issues with email sending by the provider due to the total message size.
Learn more at "When should I apply the placeholder: email.movidesk.info?"
Tip: Some placeholders are available only in triggers intended for different applications (for tickets, for email, or for knowledge base). In general, these variables can be identified by the prefix (ticket, email, or kb).
The sheet with the placeholders currently available in 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. |