Twitter/X

Упозорење

Ажурирано: 08/2023

Напомена: Тренутно у документацији користимо назив „Twitter“ или „Twitter/X“, јер је то прилично уобичајен назив и ради боље прегледности. Наравно, мислимо само на „X”.

⚠️ Због тренутне ситуације, постоје неки проблеми у вези са интеграцијом Twitter/X. Молимо погледајте Twitter/X белешка за више детаља пре него што наставите!

Zammad подржава интеграцију са Twitter-ом, што значи да можете слати и примати твитове и директне поруке баш као имејл!

Twitter тикет са нацртом одговора

Twitter тикети ће приказати 🐦 Twitter птичицу у оквиру за одговоре. Само кликните на дугме за одговор (као за имејл поруке) да бисте твитовали.

Белешка

Да бисте га подесили, следите доле наведене кораке:

  1. Пријавите се за Twitter Developer налог.

  2. Креирајте нову Twitter апликацију за Zammad.

  3. Подесите дозволе нове апликације на Read, write, and access direct messages.

  4. Генеришите нови приступни кључ и шифру.

  5. Подесите развојно окружење за Account Activity API.

  6. Додајте своју нову Twitter апликацију у Zammad.

  7. Додајте свој Twitter налог у Zammad.

  8. Подесите филтере за прављење нових тикета на основу #ознаке и @помињања.

Читајте даље за детаље о сваком кораку.

1. Пријавите се за Twitter Developer налог

Twitter Developer налог: Welcome страница

Ова страница добродошлице се приказује након завршетка пријаве за Developer налог.

Биће вам потребан обичан Twitter налог са верификованим бројем телефона да бисте се пријавили за Twitter Developer налог (на https://developer.twitter.com).

Током процеса пријаве, од вас ће се затражити да својим речима опишете шта градите. Можете користити одговор испод:

1. To manage customer service communications for our organization.
2. No.
3. Our use case involves posting original tweets in response to tweets and
   DMs we receive. We will not use the Twitter API to post or like “content”.
4. Our application will display individual tweets in their original form to
   authorized customer service agents of our organization only.

2. Направите нову Twitter апликацију за Zammad

Twitter Developer налог: Create app страница

Да бисте направили нову апликацију, изаберите Apps у корисничком менију, а затим кликните на Create an app.

Када завршите са подешавањем Developer налога, користите га да направите нову Twitter апликацију. Следећа поља су обавезна:

App name

Мора да буде јединствен на целом Twitter-у. Ниједан други Developer налог не сме да креира апликацију са истим именом.

Application description

Овде је прихватљиво било шта.

Website URL

URL адреса ваше Zammad инстанце.

Callback URLs

https://<zammad_instance>/api/v1/external_credentials/twitter/callback

Ова URL адреса је такође видљива у дијалогу Повежи Twitter апликацију у вашем администраторском панелу Zammad-а.

Tell us how this app will be used

Овде је прихватљиво било шта. Предлажемо следеће:

This app will be used to manage Twitter communications between our
customers and our organization's customer service agents on Zammad.

3. Подесите дозволе за нову апликацију

Twitter Developer налог: страница са дозволама за апликацију

Изаберите Read, write, and access direct messages.

4. Генеришите нови приступни кључ и шифру

Twitter Developer налог: App keys and tokens страница

Касније ће вам требати сва четири кључа/шифре, тако да не затварајте ову страну.

5. Подесите окружење за развој

Након што направите апликацију, подесите развојно окружење за Account Activity API.

Twitter Developer налог: Dev environments страница

Именујте га како год желите (нпр. zammad). Ознака ће вам требати касније, тако да је не заборавите.

6. Додајте своју нову Twitter апликацију у Zammad

Zammad: подешавање Twitter апликације

Додајте своју нову Twitter апликацију под Канали > Twitter у администраторском панелу. Биће вам потребни кључеви, шифре и назив развојног окружења из корака 4 и 5.

7. Додајте свој Twitter налог у Zammad

Zammad: додавање Twitter налога

Кликните на Додај налог у оквиру Канали > Twitter у администраторском панелу.

Twitter: ауторизација Zammad-а

Бићете преусмерени на Twitter и од вас ће се тражити да овластите Zammad-а да приступи вашем налогу.

8. Подешавање филтера

Zammad: подешавање Twitter налога

Подесите филтере да аутоматски отварате нове тикете на основу #ознаке или @помињања.

То је то! Сада ће се долазни твитови и директне поруке аутоматски претворити у Zammad тикете.