wixanswers 0.0.5 → 0.0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21d43335f8bcfa2fb50d395f15d2f91ebcc8dabd8232bd9c16e6aa6d1cd7d1b0
-  data.tar.gz: f007d21c8e72e016b8ab1fe1d05a94b6ea0f3773eee0fd75f805f45b4538808e
+  metadata.gz: ea25787ae420dbb146807f786bd43b8c6a2df267bbe0f3e2dcf2b766b5e047dd
+  data.tar.gz: bc06dd6724bd06cd967df6289276f46ce1276d4ece00472fbe3734957b067a0f
 SHA512:
-  metadata.gz: 79a990f97a8b3af128ac72a3d2fa372813a3eddeba6341857a6912134621877303939cd3159aac2419df1a49dcac5ec1f479e7f63621fd2aa39b95a5153aae5e
-  data.tar.gz: 447cbf3731bd905b5132054f5632cf6f311c2c5ca7598ae21985d0e5931c8b5c55167a34b050ec0a2bcb8f7e9a47badfb547f88efe85bc43084ebf08ee3fa5f0
+  metadata.gz: 9cff4fa36c1c8e019ab6614aeb9cb09ea1750b3169889630502ed4a5e2563e1f05903ee16c226104ab799f834a2c0ed777cd210ddfa42e1496264dc1b73173f3
+  data.tar.gz: 6be85a9de452e315afe3d82ad81ca0ece1d5e5cf27e861f9420646ceb21d4630753dfdc5c6521ea9a51f4dcad75e578699364ceefb569cfb1db527f8cab68acb

data/CHANGELOG.md

@@ -5,7 +5,12 @@
 * added Client class
 * added support for ticket 'Add', 'Get'
 
-0.0.5 (Stable)
+
+0.0.5.1 (Stable)
+----------------
+* added support for `AGENT_REPLY_CREATED` Webhook events 
+
+0.0.5
 ------
 * added all Enumeration objects
 * added Enumeration#title method

data/lib/wixanswers/enumerations.rb

@@ -28,7 +28,8 @@ module WixAnswers
     end
 
     class WebhookType < Enumeration
-      TICKET_CREATED ||= 2
+      TICKET_CREATED ||= 1
+      REPLY_CREATED ||= 2
       TICKET_STATUS_CHANGED ||= 8
     end
 

data/lib/wixanswers/models/ticket/ticket.rb

@@ -99,16 +99,11 @@ module WixAnswers
 
         case payload[:channel]
           when Enumerations::Channel::WEB
-            Models::Ticket.new(payload)
+            payload[:type].nil? ? Models::Ticket.new(payload) : Models::Reply.new(payload)
           when Enumerations::Channel::BY_AGENT
             Models::ByAgent.new(payload)
           when Enumerations::Channel::EMAIL
-            # support email-based tickets
-            if payload[:type].nil?
-              Models::Ticket.new(payload)
-            else
-              Models::Reply.new(payload)
-            end
+            payload[:type].nil? ? Models::Ticket.new(payload) : Models::Reply.new(payload)
           when Enumerations::Channel::PHONE_CALLBACK
             Models::PhoneCallback.new(payload)
           when Enumerations::Channel::WIDGET

data/lib/wixanswers/rest/ticket.rb

@@ -157,6 +157,185 @@ module WixAnswers
       def count(options = {})
         perform_request("/tickets/filtersCounts", :post, options)
       end
+
+      # Assign a ticket to an agent or an agent group.
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#assign-a-ticket
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      def assign(ticket_id)
+        WixAnswers::Models::Ticket.new(perform_request("/tickets/#{ticket_id}/assign", :post))
+      end
+
+      # Assign one or more tickets to an agent or an agent group.
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#assign-one-or-more-tickets
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <Array[WixAnswers::Models::Ticket]>
+      # @param options [Hash] A customizable set of options
+      # @option ids [String] List of tickets to assign.
+      # @option assignedGroupId [String] The agent group to which to assign the ticket.
+      #                                  This parameter or assignedUserId is required (but not both.
+      # @option assignedUserId [String] The agent to whom to assign the ticket.
+      #                                 This parameter or assignedGroupId is required (but not both).
+      def assign_many(options={})
+        perform_request("/tickets/assign", :post, options).map {|ticket| WixAnswers::Models::Ticket.new(ticket)}
+      end
+
+      # Remove the agent or group assignment from a ticket.
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#unassign-a-ticket
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      def unassign(ticket_id)
+        WixAnswers::Models::Ticket.new(perform_request("/tickets/#{ticket_id}/unassign", :post))
+      end
+
+      # Remove the agent or group assignment from one or more tickets.
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#unassign-one-or-more-tickets
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <Array[WixAnswers::Models::Ticket]>
+      # @param options [Hash] A customizable set of options
+      # @option ids [String] List of tickets to unassign.
+      # @option assignedGroupId [String] The agent group to which to unassign the ticket.
+      #                                  This parameter or assignedUserId is required (but not both.
+      # @option assignedUserId [String] The agent to whom to unassign the ticket.
+      #                                 This parameter or assignedGroupId is required (but not both).
+      def unassign_many(options={})
+        perform_request("/tickets/unassign", :post, options).map {|ticket| WixAnswers::Models::Ticket.new(ticket)}
+      end
+
+      # Mark a ticket as spam
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#mark-a-ticket-as-spam
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      def mark_spam(ticket_id)
+        perform_request("/tickets/#{ticket_id}/markSpam", :post)
+      end
+
+      # Mark a ticket as not spam
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#mark-a-ticket-as-not-spam
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      def mark_not_spam(ticket_id)
+        perform_request("/tickets/#{ticket_id}/markHam", :post)
+      end
+
+      # Mark one or more tickets as spam
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#mark-one-or-more-tickets-as-spam
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <Array[WixAnswers::Models::Ticket]>
+      # @param options [Hash] A customizable set of options
+      # @option ids [String] List of tickets to mark as spam.
+      def mark_spam_many(options={})
+        perform_request("/tickets/markSpam", :post, options)
+      end
+
+      # Mark one or more tickets as not spam
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#mark-one-or-more-tickets-as-not-spam
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <Array[WixAnswers::Models::Ticket]>
+      # @param options [Hash] A customizable set of options
+      # @option ids [String] List of tickets to mark as spam.
+      def mark_not_spam_many(options={})
+        perform_request("/tickets/markHam", :post, options)
+      end
+
+      # Authenticate a ticket.
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#authenticate-a-ticket
+      # @authorization Requires agent authorization token and permission MANAGE_TICKETS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      def authenticate(ticket_id)
+        WixAnswers::Models::Ticket.new(perform_request("/tickets/#{ticket_id}/authenticate", :post))
+      end
+
+      # Transfer a ticket; this changes the user associated with a ticket. Use when an existing ticket
+      # is found to be relevant for the user, such as one opened initially for an unauthenticated user.
+      # For example, when a) an unauthenticated user is created from an email and then b) an agent moves
+      # the ticket to an existing authenticated user.
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#change-a-tickets-user-transfer-a-ticket
+      # @authorization Requires agent authorization token and permission MANAGE_TICKETS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      # @param options [Hash] A customizable set of options
+      # @option targetUserId [String] The new user
+      def transfer(ticket_id, options={})
+        WixAnswers::Models::Ticket.new(perform_request("/tickets/#{ticket_id}/transfer", :post, options))
+      end
+
+      # Update a ticket's status
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#update-a-tickets-status
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      # @param options [Hash] A customizable set of options
+      # @option status [Integer] The new Ticket Status
+      def update_status(ticket_id, options={})
+        WixAnswers::Models::Ticket.new(perform_request("/tickets/#{ticket_id}/status", :put, options))
+      end
+
+      # Update one or more tickets' statuses
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#update-status-of-one-or-more-tickets
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <Array[WixAnswers::Models::Ticket]>
+      # @param options [Hash] A customizable set of options
+      # @option ids [Array<String>] List of tickets for which to change the status
+      # @option status [Integer] The new Ticket Status
+      def update_status_many(options={})
+        perform_request("/tickets/setStatus", :post, options).map {|ticket| WixAnswers::Models::Ticket.new(ticket)}
+      end
+
+      # Update a ticket's priority
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#update-a-tickets-priority
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <WixAnswers::Models::Ticket>
+      # @param ticket_id [String] Ticket GUID
+      # @param options [Hash] A customizable set of options
+      # @option priority [Integer] New Ticket Priority
+      def update_priority(ticket_id, options={})
+        WixAnswers::Models::Ticket.new(perform_request("/tickets/#{ticket_id}/priority", :put, options))
+      end
+
+      # Update one or more tickets' priorities
+      #
+      # @see https://help.wixanswers.com/kb/en/article/ticket-apis#update-priority-of-one-or-more-tickets
+      # @authorization Requires agent authorization token and permission BASIC_TICKET_ACTIONS
+      # @raise [WixAnswers::Exceptions::Unauthorized] Error raised when supplied agent credentials are not valid.
+      # @return <Array[WixAnswers::Models::Ticket]>
+      # @param options [Hash] A customizable set of options
+      # @option ids [Array<String>] List of tickets for which to change the status
+      # @option priority [Integer] New Ticket Priority
+      def update_priority_many(options={})
+        perform_request("/tickets/setPriority", :post, options).map {|ticket| WixAnswers::Models::Ticket.new(ticket)}
+      end
     end
   end
 end

data/lib/wixanswers/version.rb

@@ -15,7 +15,7 @@ module WixAnswers
     end
 
     def pre
-      nil
+      1
     end
 
     def to_h

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wixanswers
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.5.1
 platform: ruby
 authors:
 - Roee Sheelo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-11-22 00:00:00.000000000 Z
+date: 2021-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler