Informazioni su Liquid markup e Zendesk Support

Data ultima modifica: 19 mar 2025

Suite

Qualsiasi piano

Support

Qualsiasi piano

Se sai come usare i segnaposto in Zendesk Support, hai già una certa conoscenza di Liquid markup, ovvero il linguaggio di modellazione che usiamo per abilitarli. I segnaposto vengono usati nelle automazioni, nelle macro, nei trigger e nei widget come contenitori di dati utente e ticket generati dinamicamente. Ciò che forse non sai a proposito di Liquid markup è che puoi usarlo anche per personalizzare il modo in cui questi dati vengono selezionati e visualizzati come output. Questo perché Liquid consente di creare una logica di programmazione semplice come istruzioni case, istruzioni if, cicli for e così via.

Scrivendo semplici istruzioni di controllo direttamente nell’azione commento/descrizione nelle macro e nell’azione email dell’utente nelle automazioni e nei trigger dei ticket, puoi eseguire in un’unica automazione, macro o attivare ciò che dovevi fare in più automazioni, macro e trigger. Puoi anche personalizzare la presentazione del testo dei commenti. Questa opzione non è supportata per i trigger di messaggistica.

La documentazione di Liquid è disponibile nella pagina Liquid for Designers, che contiene una descrizione dettagliata di tutti gli elementi del linguaggio. Una breve descrizione del funzionamento del linguaggio è comunque esposta di seguito.

Liquid è un linguaggio di modellazione per il rendering di email e HTML. È il meccanismo che consente l’inserimento automatico di dati in commenti e notifiche email mediante l’uso di segnaposto.

Esistono due tipi di markup in Liquid:

Output, ovvero output di testo racchiuso tra parentesi graffe doppie.
Tag, che contengono la logica di programmazione che determina il modo in cui i dati vengono espressi con segnaposto.

Se assimili output e segnaposto, sei sulla buona strada per capire cosa sia Liquid e come viene usato. Tuttavia, ciò che forse non sai riguardo l’output di Liquid è che oltre a esprimere dati utente e ticket, esistono metodi che consentono di manipolare array e stringhe di testo. In Liquid, questi metodi sono denominati filtri. Usando un filtro, ad esempio, puoi trasformare il testo in caratteri maiuscoli. Ma questo è uno degli esempi più semplici di come possono essere usati i filtri. Consulta la documentazione di Liquid per maggiori informazioni.

Per comprendere perfettamente come usare Liquid, è necessario sapere cosa sono i tag e come vengono usati. I tag forniscono la logica di programmazione che puoi usare per selezionare e presentare i dati.

Usando i tag Liquid puoi creare:

Istruzioni if else
Istruzioni case
Cicli for
Cicli
Assegnazioni di variabili

Per altri esempi d’uso di Liquid markup, consulta i seguenti articoli:

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.

65 commenti

Data

Più recenti

Rafael Santos

24 apr 2024

1900216093524 , I'd use the PUT /api/v2/tickets/{ticket_id}/tags endpoint instead of PUT /api/v2/tickets/update_many, as the latter creates a background job, which may be rate limited to 30 concurrent jobs for the entire instance.

You could use the Add Tags endpoint, as mentioned above, with a payload such as the following:

{
{%- assign randomizer = ticket.id | modulo: 2 -%}
{%- case randomizer -%}
	{%- when 0 -%}
		{%- assign randomTag = 'control' -%}
	{%- when 1 -%}
		{%- assign randomTag = 'experiment' -%}
{%- endcase -%}
	"tags": ["{{ randomTag }}"]
}

As for your other question:

How would I use liquid markup in this JSON response to tell it not to fire if a ticket already has the control or experiment tag?

The following trigger conditions could help you exclude this from firing on follow-up tickets with the tags:

Ticket Is Created
Channel Is not Closed ticket
Tags Contains non of the following: [ control, experiment ]

Of course, it'll depend on your specific use case. You could also try iterating over the {{ticket.tags}} placeholder and use Liquid's contains.

Andy F.

23 apr 2024

Hi Zendesk community! I have a question about using Liquid Markup with Zendesk ticket tags. I've set up A/B testing in our instance (as described in this article: https://ro.roca.work/blog/ab-testing-in-zendesk) and so far, it's mostly been working for us. However, I just identified a scenario that I can't figure out how to solve.

To summarize, every ticket that is created gets assigned either the control or experiment tag. The problem occurs only sometimes with tickets created as followups, as it's possible for a ticket to carry over the previous tags, like control, but then get assigned the experiment tag by the webhook. How would I use liquid markup in this JSON response to tell it not to fire if a ticket already has the control or experiment tag?

{% assign randomizer = ticket.id | modulo:2 %}

{% case randomizer %}

{% when 0 %}

{“ticket”: {“additional_tags”:[“control”]}}

{% when 1 %}

{“ticket”: {“additional_tags”:[“experiment”]}}

{% endcase %}

Thanks in advance for the help!

Dainne Kiara Lucena-Laxamana

01 apr 2024

Hi Oliver!

Greg one of our developers created a workflow guide here that could serve helpful. Hope it helps!

Oliver Atkinson

19 mar 2024

Hello,

Is it possible to change requesters based on the ticket subject using a combination of triggers and liquid markup/webhooks?

I'd use a webhook + automation combination but ideally, we'd need the requester to change immediately rather than wait the 1-hour increment.

The use case is so we don't have to manually change requesters from a no-reply address.
It's trying to create a solution to this question. Any assistance would be greatly appreciated!

Mike DR

06 mar 2024

Hi Hannah!

You're most welcome and have an awesome day ahead too!

Hannah Lucid

06 mar 2024

1263082264889 I had a feeling that would be the case. I looked EVERYWHERE for something. Thank you for your confirmation Mike!! Have a great day.

Mike DR

05 mar 2024

HeyA Hannah!

Did a thorough search on this and didn't see a liquid mark up here for highlights: Liquid for Designers.

Hannah Lucid

04 mar 2024

Hello,

Is there a way to highlight text using liquid markup? We want to highlight text in our Macros to help callout important information to our end-users (if they read nothing else, at least they'll read this). Is this possible? If so, how?