Wersja 10.19

Aktualizacja aplikacji do wersji 10.19.

🎯 Cel wersji

Celem wprowadzonej wersji jest rozszerzenie i ujednolicenie sposobu identyfikacji zgłoszeń w akcjach EAPI.

Dotychczas komunikacja z API opierała się wyłącznie na wewnętrznych identyfikatorach (tickets_id ), które nie były widoczne dla użytkowników w panelu Welyo. Utrudniało to korzystanie z akcji dodawania i aktualizacji zgłoszeń w sytuacjach, gdy użytkownik posługiwał się identyfikatorami widocznymi w interfejsie lub pochodzącymi z zewnętrznych systemów.

👥Kogo dotyczą zmiany?

Zmiany dotyczą przede wszystkim użytkowników korzystających z integracji poprzez EAPI.

Zmiana nie dotyczy bezpośrednio końcowych użytkowników panelu Welyo (np. konsultantów czy agentów obsługi), ponieważ interfejs użytkownika pozostaje bez zmian.

🔧Na jaki obszar wpływa zmiana?

Zmiana dotyczy interfejsu API (EAPI) odpowiedzialnego za dodawanie i aktualizację zgłoszeń w systemie Welyo.

Wpływa bezpośrednio na:

• Integracje zewnętrzne korzystające z akcji desk-add-tickets  i desk-update-tickets ,
• Systemy, które komunikują się z Welyo poprzez API w celu tworzenia lub edycji zgłoszeń,
• Procesy automatyzacji i skrypty, które wcześniej opierały się wyłącznie na identyfikatorze tickets_id .

Zmiana nie wpływa na interfejs użytkownika w panelu Welyo, ale ma znaczenie dla zespołów technicznych lub partnerów korzystających z integracji API.

🧩Czy zmiana wymaga konsultacji z wewnętrznym działem IT?

Tak, zalecana jest konsultacja z działem IT (lub osobą odpowiedzialną za integracje).

🔄Zmiany

Modyfikacja akcji EAPI umożliwiających dodawanie i aktualizację zgłoszeń

1. desk-add-tickets

Obecnie po wywołaniu akcji dodawania zgłoszenia zwracana była następująca odpowiedź:

{  "success": true,  "tickets_id": [  137835  ] }   

W strukturze tickets_id były zwracane wszystkie identyfikatory dodanych zgłoszeń. Wprowadzono w związku z tym modyfikację, dzięki której po wywołaniu akcji dodawania zgłoszeń zwrócone zostaną również identyfikatory, które są widoczne w panelu Welyo:

{  "success": true,  "tickets_id": [  137835  ],  "tickets_identifier": [  "1420413827"  ] }   

Ta druga struktura o nazwie tickets_identifier to właśnie lista identyfikatorów dodanych zgłoszeń odpowiadająca identyfikatorom wyświetlanym w panelu.

2. desk-update-tickets

Również akcja umożliwiająca aktualizację zgłoszeń zostaje zmodyfikowana. Do tej pory operowała ona na tickets_id, czyli identyfikatorach zgłoszenia niewidocznych w żaden sposób dla użytkownika panelu Welyo. Uniemożliwiało to skuteczne operowanie na tej akcji, bazując na widocznych w systemie danych. W związku z tym wprowadzono modyfikację, która umożliwia podczas aktualizacji zgłoszenia podanie:

• tickets_id - tak jak dotychczas,
• external_id - identyfikator z zewnętrznego systemu przypisany do zgłoszenia,
• tickets_identifier - czyli identyfikator zgłoszenia widoczny w panelu Welyo

Wywołanie akcji będzie więc wyglądało następująco:

{  "campaign_id": "123",  "tickets": [  {  "id": "1",  "external_id": "123",  "tickets_identifier":"1420413827",  "records_id": "4",  "subject": "Topic 1",  "description": "Description",  "type_id": "1",  "source_id": "-1",  "state_id": "2",  "priorities_id": "1",  "agents_id": 1,  "tickets_parameters": {  "users_custom_parameter_name_1": "123-123-123-XYZ",  "users_custom_parameter_name_2": "phone"  }  }  ] }   

Ważne jest to, aby przy wywołaniu akcji korzystać tylko z jednego wybranego parametru. Nie można ich mieszać między sobą. Jeżeli przy wywołaniu podamy więcej niż jeden parametr określający identyfikator zgłoszenia, system wybierze ten ważniejszy według hierarchii:

1. ID
2. external_id
3. tickets_identifier