qismo 0.12.1 → 0.14.0

data/lib/qismo/api.rb

@@ -8,20 +8,40 @@ module Qismo
     #
     # @see https://s.id/list-customer-rooms
     # @param options [Hash]
-    # @return [Qismo::CollectionObject]
+    #   List room optional filters
+    # @option options [String] :status
+    #   Filter by room status. Valid values are "resolved", "unresolved", "expired", or "almost_expired"
+    # @option options [String] :serve_status
+    #   Filter by room serve status. Valid values are "served" or "unserved"
+    # @option options [Array<Hash>] :channels
+    #   Filter by channels. Example: [{ source: "wa", channel_id: 716171 }]
+    # @option options [TrueClass,FalseClass] :is_handled_by_bot
+    #   Filter by bot handling status
+    # @option options [String] :name
+    #   Filter by customer name
+    # @option options [Integer] :limit
+    #   Number of data returned in one page. Default is 50
+    # @option options [String] :order
+    #   Order data by timestamp. Can be ordered "asc" or "desc". Default is "desc"
+    # @option options [String] :cursor_after
+    #   Next page cursor. If you are on last page, the cursor returned will be nil
+    # @option options [String] :cursor_before
+    #   Previous page cursor. If you are on first page, the cursor returned will be nil
+    # @option options [Array<Integer>] :tag_ids
+    #   Filter by tags
+    # @option options [Array<Integer>] :user_ids
+    #   Filter by agent who handled or assigned to the room
+    # @return [Qismo::Collection<Qismo::CustomerRoom>]
     def rooms(options = {})
       body = post("/api/v2/customer_rooms", options)
-      CollectionObject.new(
-        body.data.customer_rooms,
-        prev_page: body.meta&.cursor_before,
-        next_page: body.meta&.cursor_after,
-        prev_func: -> { rooms(options.merge(cursor_before: body.meta&.cursor_before)) },
-        next_func: -> { rooms(options.merge(cursor_after: body.meta&.cursor_after)) }
+      Collection.new(
+        Qismo::Objects::CustomerRoom.from_array(body.data.customer_rooms),
+        next_page: body.meta.cursor_after,
+        prev_page: body.meta.cursor_before
       )
     end
 
     # Get room by id
-    #
     # @see https://s.id/get-room-by-room-id
     # @param room_id [Integer]
     # @return [Qismo::SingleObject]
@@ -31,16 +51,20 @@ module Qismo
         raise Qismo::NotFoundError.new("Room not found", status_code: 404, response_body: body.to_json)
       end
 
-      body.data.customer_room
+      Qismo::Objects::CustomerRoom.new(body.data.customer_room)
     end
 
     # List tags inside room
     #
     # @see https://s.id/list-room-tags
     # @param room_id [Integer]
-    # @return [Qismo::CollectionObject]
+    # @return [Qismo::Collection<Qismo::Objects::Tag>]
     def room_tags(room_id)
-      CollectionObject.new(get("/api/v2/room_tags/#{room_id}").data)
+      Qismo::Collection.new(
+        Qismo::Objects::Tag.from_array(
+          get("/api/v2/room_tags/#{room_id}").data
+        )
+      )
     end
 
     # Add room tag
@@ -48,9 +72,11 @@ module Qismo
     # @see https://s.id/add-room-tag
     # @param room_id [Integer]
     # @param tag_name [String]
-    # @return [Qismo::SingleObject]
+    # @return [Qismo::Objects::Tag]
     def add_room_tag(room_id, tag_name)
-      post("/api/v2/room_tags/#{room_id}", tag: tag_name).data
+      Qismo::Objects::Tag.new(
+        post("/api/v2/room_tags/#{room_id}", tag: tag_name).data
+      )
     end
 
     # Delete room tag
@@ -68,13 +94,13 @@ module Qismo
     #
     # @see https://s.id/list-room-info
     # @param room_id [Integer]
-    # @return [Qismo::CollectionObject]
+    # @return [Array<Qismo::Objects::RoomAdditionalInfo>]
     def room_additional_info(room_id)
-      CollectionObject.new(
-        get(
-          "/api/v1/qiscus/room/#{room_id}/user_info"
-        ).data&.extras&.user_properties
-      ) || CollectionObject.new
+      Qismo::Objects::RoomAdditionalInfo.from_array(
+        get("/api/v1/qiscus/room/#{room_id}/user_info").data.extras.user_properties
+      )
+    rescue NoMethodError
+      Qismo::Objects::RoomAdditionalInfo.from_array([])
     end
 
     alias_method :room_info, :room_additional_info
@@ -85,14 +111,15 @@ module Qismo
     # @note This will replace your current room additional info
     # @param room_id [Integer]
     # @param additional_info [Array<Hash>]
-    # @return [Qismo::CollectionObject]
+    #   Key value pair of additional info. Ex: [{ key: "Ticket Link", value: "https://ticket.com" }]
+    # @return [Array<Qismo::Objects::RoomAdditionalInfo>]
     def set_room_additional_info(room_id, additional_info)
-      CollectionObject.new(
+      Qismo::Objects::RoomAdditionalInfo.from_array(
         post(
           "/api/v1/qiscus/room/#{room_id}/user_info",
           user_properties: additional_info
-        ).data&.extras&.user_properties
-      ) || CollectionObject.new
+        ).data.extras.user_properties
+      )
     end
 
     alias_method :set_room_info, :set_room_additional_info
@@ -102,11 +129,12 @@ module Qismo
     # Update room additional info
     #
     # @param room_id [Integer]
-    # @param additional_info [Array]
-    # @return [Qismo::CollectionObject]
+    # @param additional_info [Array<Hash>]
+    #   Key value pair of additional info. Ex: [{ key: "Ticket Link", value: "https://ticket.com" }]
+    # @return [Array<Qismo::Objects::RoomAdditionalInfo>]
     def update_room_additional_info(room_id, additional_info)
-      old_additional_info = room_additional_info(room_id)
-      new_additional_info = (additional_info + old_additional_info).uniq { |h| h.values_at("key") }
+      old_additional_info = room_additional_info(room_id).as_json
+      new_additional_info = (additional_info.as_json + old_additional_info).uniq { |h| h.values_at("key") }
       set_room_additional_info(room_id, new_additional_info)
     end
 
@@ -118,31 +146,49 @@ module Qismo
     # @param room_id [Integer]
     # @param options [Hash]
     # @return [Qismo::CollectionObject]
-    def room_broadcast_history(room_id, options = {})
-      body = get("/api/v2/customer_rooms/#{room_id}/broadcast_history", options)
-
-      next_page = (body.meta.page < body.meta.total_page) ? (body.meta.page + 1) : nil
-      prev_page = (body.meta.page > 1) ? (body.meta.page - 1) : nil
 
-      CollectionObject.new(
-        body.data.broadcast_logs,
-        next_page: next_page,
-        prev_page: prev_page,
-        next_func: -> { room_broadcast_history(options.merge(page: next_page)) },
-        prev_func: -> { room_broadcast_history(options.merge(page: prev_page)) }
+    # List broadcast history inside room
+    #
+    # @param room_id [Integer]
+    # @param page [Integer]
+    # @param limit [Integer]
+    # @return [Qismo::Collection<Qismo::Objects::BroadcastLog>]
+    def room_broadcast_history(room_id, page: 1, limit: 25)
+      body = get("/api/v2/customer_rooms/#{room_id}/broadcast_history", {
+        page: page,
+        limit: limit
+      })
+
+      Qismo::Collection.new(
+        Qismo::Objects::BroadcastLog.from_array(body.data.broadcast_logs),
+        next_page: ((body.meta.page < body.dig("meta", "total_page")) ? (body.meta.page + 1) : nil),
+        prev_page: ((body.meta.page > 1) ? (body.meta.page - 1) : nil)
       )
     end
 
-    # Assign agent to room
+    # Assign an agent to a room
     #
-    # @see https://s.id/assign-agent
     # @param room_id [Integer]
     # @param agent_id [Integer]
-    # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def assign_agent(room_id, agent_id, options = {})
-      body = post("/api/v1/admin/service/assign_agent", options.merge(room_id: room_id.to_s, agent_id: agent_id))
-      body.data.added_agent
+    # @param replace_agents [TrueClass,FalseClass]
+    #   Replace agents in room or not. Don't combine this param
+    #   with :max_agent param
+    # @param max_agent [Integer]
+    #   Specify max agent that can be assigned to a room. For
+    #   example, if there are 1 agent in a room and you specific
+    #   max_agent to 1, you will get bad request error. If you set
+    #   param :relpace_agents to true, this param will be forced
+    #   to nil, which no be sent on http request
+    # @return [Qismo::Objects::User]
+    def assign_agent(room_id, agent_id, replace_agents: false, max_agent: nil)
+      Qismo::Objects::User.new(
+        post("/api/v1/admin/service/assign_agent", {
+          room_id: room_id.to_s,
+          agent_id: agent_id,
+          replace_latest_agent: replace_agents,
+          max_agent: (replace_agents == true) ? nil : max_agent
+        }).data.assign_agent
+      )
     end
 
     # Remove agent from room
@@ -152,7 +198,13 @@ module Qismo
     # @param agent_id [Integer]
     # @return [TrueClass]
     def remove_agent(room_id, agent_id)
-      post("/api/v1/admin/service/remove_agent", room_id: room_id.to_s, agent_id: agent_id)
+      post(
+        "/api/v1/admin/service/remove_agent", {
+          room_id: room_id.to_s,
+          agent_id: agent_id
+        }
+      )
+
       true
     end
 
@@ -161,12 +213,27 @@ module Qismo
     # @see https://s.id/resolve-room
     # @param room_id [Integer]
     # @param last_comment_id [Integer]
-    # @param options [Hash]
+    #   Id of last message in the room. If you dont specify this param,
+    #   we will use current epoc timestamp
+    # @param notes [String]
+    #   Specify room notes. You can also use simple markdown markup
+    #   for this param
+    # @param send_email [TrueClass,FalseClass]
+    #   Send email to customer or no. This param will only worked if
+    #   you are using valid email as customer identifier
+    # @param extras [Hash]
+    #   Room extras in valid hash
     # @return [Qismo::SingleObject]
-    def resolve_room(room_id, last_comment_id, options = {})
-      body = post("/api/v1/admin/service/mark_as_resolved",
-        options.merge(room_id: room_id.to_s, last_comment_id: last_comment_id))
-      body.data.service
+    def resolve_room(room_id, last_comment_id: Time.now.to_i, notes: nil, send_email: false, extras: nil)
+      Qismo::Objects::AgentService.new(
+        post("/api/v1/admin/service/mark_as_resolved", {
+          room_id: room_id.to_s,
+          last_comment_id: last_comment_id,
+          notes: notes,
+          is_send_email: send_email,
+          extras: extras
+        }).data.service
+      )
     end
 
     alias_method :resolve, :resolve_room
@@ -175,38 +242,64 @@ module Qismo
     #
     # @see https://s.id/allocate-agent
     # @param source [String]
-    # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def allocate_agent(source, options = {})
-      body = post("/api/v1/admin/service/allocate_agent", options.merge(source: source))
-      body.data.agent
+    #   Channel source. Available sources are `wa`, `line`, `telegram`,
+    #   `qiscus`, `ig`, or `fb`. For custom channel, use that channel's
+    #   identifier_key as source
+    # @param channel_id [Integer]
+    #   The channel id you want to allocate
+    # @param ignore_availability [TrueClass,FalseClass]
+    #   Ignore agent availability. If you set this param to true, agent
+    #   that are unavailable will be considered as allocatable too
+    # @return [Qismo::Objects::User]
+    def allocate_agent(source, channel_id, ignore_availability: false)
+      Qismo::Objects::User.new(
+        post("/api/v1/admin/service/allocate_agent", {
+          source: source,
+          channel_id: channel_id,
+          ignore_availability: ignore_availability
+        }).data.agent
+      )
     end
 
     # Get agent that can be allocated to room and automatically assign them
     #
     # @see https://s.id/allocate-and-assign-agent
     # @param room_id [Integer]
-    # @param options [Hash]
+    # @param ignore_availability [TrueClass,FalseClass]
+    #   Ignore agent availability. If you set this param to true, agent
+    #   that are unavailable will be considered as allocatable too
     # @return [Qismo::SingleObject]
-    def allocate_and_assign_agent(room_id, options = {})
-      body = post("/api/v1/admin/service/allocate_assign_agent", options.merge(room_id: room_id))
-      body.data.agent
+    def allocate_and_assign_agent(room_id, ignore_availability: false)
+      Qismo::Objects::User.new(
+        post("/api/v1/admin/service/allocate_assign_agent", {
+          room_id: room_id.to_s,
+          ignore_availability: ignore_availability
+        }).data.agent
+      )
     end
 
     # List agents that are not in room and can be assigned to room
     #
     # @see https://s.id/list-other-agents
     # @param room_id [Integer]
-    # @param options [Hash]
-    # @return [Qismo::CollectionObject]
-    def other_agents(room_id, options = {})
-      body = get("/api/v2/admin/service/other_agents", options.merge(room_id: room_id))
-      CollectionObject.new(
-        body.data.agents,
-        prev_page: body.meta&.cursor_before,
-        next_page: body.meta&.cursor_after,
-        prev_func: -> { other_agents(options.merge(cursor_before: body.meta&.cursor_before)) },
-        next_func: -> { other_agents(options.merge(cursor_after: body.meta&.cursor_after)) }
+    # @param search [String]
+    # @param limit [Integer]
+    # @param cursor_after [String]
+    # @param cursor_before [String]
+    # @return [Qismo::Collection<Qismo::Objects::User>]
+    def other_agents(room_id, search: nil, limit: 15, cursor_after: nil, cursor_before: nil)
+      body = get("/api/v2/admin/service/other_agents", {
+        room_id: room_id.to_s,
+        search: search,
+        limit: limit,
+        cursor_after: cursor_after,
+        cursor_before: cursor_before
+      })
+
+      Collection.new(
+        Qismo::Objects::User.from_array(body.data.agents),
+        next_page: body.meta.cursor_after,
+        prev_page: body.meta.cursor_before
       )
     end
 
@@ -214,100 +307,132 @@ module Qismo
     #
     # @see https://s.id/list-available-agents
     # @param room_id [Integer]
-    # @param options [Hash]
-    # @return [Qismo::CollectionObject]
-    def available_agents(room_id, options = {})
-      body = get("/api/v2/admin/service/available_agents", options.merge(room_id: room_id))
-      CollectionObject.new(
-        body.data.agents,
-        prev_page: body.meta&.cursor_before,
-        next_page: body.meta&.cursor_after,
-        prev_func: -> { available_agents(options.merge(cursor_before: body.meta&.cursor_before)) },
-        next_func: -> { available_agents(options.merge(cursor_after: body.meta&.cursor_after)) }
+    # @param available_in_room [TrueClass,FalseClass]
+    # @param search [String]
+    # @param limit [Integer]
+    # @param cursor_after [String]
+    # @param cursor_before [String]
+    # @return [Qismo::Collection<Qismo::Objects::User>]
+    def available_agents(room_id, available_in_room: true, search: nil, limit: 15, cursor_after: nil, cursor_before: nil)
+      body = get("/api/v2/admin/service/available_agents", {
+        room_id: room_id.to_s,
+        is_available_in_room: available_in_room,
+        search: search,
+        limit: limit,
+        cursor_after: cursor_after,
+        cursor_before: cursor_before
+      })
+
+      Collection.new(
+        Qismo::Objects::User.from_array(body.data.agents),
+        next_page: body.meta.cursor_after,
+        prev_page: body.meta.cursor_before
       )
     end
 
     # Get new session webhook config
     #
-    # @return [Qismo::SingleObject]
+    # @return [Qismo::Objects::Webhook]
     def new_session_webhook
-      get("/api/v2/app/config/new_session_webhook").data.configs
+      config = get("/api/v2/app/config/new_session_webhook").data.configs
+      Qismo::Objects::Webhook.new(
+        enabled: config.is_new_session_webhook_enabled,
+        url: config.new_session_webhook_url
+      )
     end
 
     # Set new session webhook
     #
     # @param url [String]
-    # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def set_new_session_webhook(url, options = {})
-      post("/api/v2/app/config/new_session_webhook", options.merge(url: url)).data.configs
+    # @param enabled [TrueClass,FalseClass]
+    # @return [Qismo::Objects::Webhook]
+    def set_new_session_webhook(url, enabled: true)
+      config = post("/api/v2/app/config/new_session_webhook", url: url, enabled: enabled).data.configs
+      Qismo::Objects::Webhook.new(
+        enabled: config.is_new_session_webhook_enabled,
+        url: config.new_session_webhook_url
+      )
     end
 
     # Get auth webhook config
     #
     # @return [Qismo::SingleObject]
     def auth_webhook
-      get("/api/v2/app/config/auth_webhook").data.configs
+      config = get("/api/v2/app/config/auth_webhook").data.configs
+      Qismo::Objects::Webhook.new(
+        enabled: config.is_auth_webhook_enabled,
+        url: config.auth_webhook_url
+      )
     end
 
     # Set auth webhook
     #
     # @param url [String]
     # @param enabled [TrueClass, FalseClass]
-    # @param options [Hash]
     # @return [Qismo::SingleObject]
-    def set_auth_webhook(url, enabled = true, options = {})
-      post("/api/v2/app/config/auth_webhook", options.merge(url: url, enabled: enabled)).data.configs
+    def set_auth_webhook(url, enabled: true)
+      config = post("/api/v2/app/config/auth_webhook", url: url, enabled: enabled).data.configs
+      Qismo::Objects::Webhook.new(
+        enabled: config.is_auth_webhook_enabled,
+        url: config.auth_webhook_url
+      )
     end
 
     # Get resolve webhook config
     #
-    # @return [Qismo::SingleObject]
+    # @return [Qismo::Objects::Webhook]
     def resolve_webhook
-      get("/api/v1/app/webhook/mark_as_resolved").data
+      config = get("/api/v1/app/webhook/mark_as_resolved").data
+      Qismo::Objects::Webhook.new(
+        enabled: config.is_mark_as_resolved_webhook_enabled,
+        url: config.mark_as_resolved_webhook_url
+      )
     end
 
     # Set resolve webhook
     #
     # @param url [String]
     # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def set_resolve_webhook(url, options = {})
-      post("/api/v1/app/webhook/mark_as_resolved", options.merge(url: url)).data
+    # @return [Qismo::Objects::Webhook]
+    def set_resolve_webhook(url, enabled: true)
+      config = post("/api/v1/app/webhook/mark_as_resolved", webhook_url: url, is_webhook_enabled: enabled).data
+      Qismo::Objects::Webhook.new(
+        enabled: config.is_mark_as_resolved_webhook_enabled,
+        url: config.mark_as_resolved_webhook_url
+      )
     end
 
     # List agents
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#849205ca-00d9-4356-9fdd-f05bff777b4e
     # @param options [Hash]
-    # @return [Qismo::CollectionObject]
-    def agents(options = {})
-      if options[:page].nil? || options[:page].empty?
-        options[:page] = 1
-      end
-
-      body = get("/api/v2/admin/agents", options)
+    # @return [Qismo::Collection<Qismo::Objects::User>]
+    def agents(page: 1, limit: 10, search: nil, scope: nil)
+      body = get("/api/v2/admin/agents", {
+        page: page,
+        limit: limit,
+        search: search,
+        scope: scope
+      })
 
       total_page = (body.meta.total_count.to_f / body.meta.per_page.to_f).ceil
-      next_page = (options[:page] < total_page) ? (options[:page] + 1) : nil
-      prev_page = (options[:page] > 1) ? (options[:page] - 1) : nil
 
-      CollectionObject.new(
-        body.data.agents,
-        next_page: next_page,
-        prev_page: prev_page,
-        next_func: -> { agents(options.merge(page: next_page)) },
-        prev_func: -> { agents(options.merge(page: prev_page)) }
+      Qismo::Collection.new(
+        Qismo::Objects::User.from_array(body.data.agents),
+        next_page: ((page < total_page) ? (page + 1) : nil),
+        prev_page: ((page > 1) ? (page - 1) : nil)
       )
     end
 
-    # List agents by id
+    # List agents by ids
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#3db6c8c8-8ffe-4a88-b630-41f9d5b62298
     # @param ids [Array<Integer>]
-    # @return [Qismo::CollectionObject]
+    # @return [Qismo::Collection<Qismo::Objects::User>]
     def agents_by_ids(ids)
-      CollectionObject.new(get("/api/v1/admin/agents/get_by_ids", {"ids[]": ids}).data) || CollectionObject.new
+      Qismo::Collection.new(
+        Qismo::Objects::User.from_array(get("/api/v1/admin/agents/get_by_ids", {"ids[]": ids}).data)
+      )
     end
 
     # List agents by divisions
@@ -315,19 +440,20 @@ module Qismo
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#94eeb9cb-dd70-4baf-9f63-361e7922299a
     # @param division_ids [Array<Integer>]
     # @param options [Hash]
-    # @return [Qismo::CollectionObject]
-    def agents_by_divisions(division_ids, options = {})
-      body = get("/api/v2/admin/agents/by_division", options.merge({"division_ids[]": division_ids}))
-
-      next_page = (body.meta.page < body.meta.total_page) ? (body.meta.page + 1) : nil
-      prev_page = (body.meta.page > 1) ? (body.meta.page - 1) : nil
-
-      CollectionObject.new(
-        body.data,
-        next_page: next_page,
-        prev_page: prev_page,
-        next_func: -> { agents_by_divisions(options.merge(page: next_page)) },
-        prev_func: -> { agents_by_divisions(options.merge(page: prev_page)) }
+    # @return [Qismo::Collection<Qismo::Objects::User>]
+    def agents_by_divisions(division_ids, page: 1, limit: 10, available: nil, sort: "asc")
+      body = get("/api/v2/admin/agents/by_division", {
+        "division_ids[]": division_ids,
+        page: page,
+        limit: limit,
+        is_available: available,
+        sort: sort
+      })
+
+      Qismo::Collection.new(
+        Qismo::Objects::User.from_array(body.data),
+        next_page: ((body.meta.page < body.meta.total_page) ? (body.meta.page + 1) : nil),
+        prev_page: ((body.meta.page > 1) ? (body.meta.page - 1) : nil)
       )
     end
 
@@ -335,21 +461,19 @@ module Qismo
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#c6184a6b-ba4d-4f3e-a4da-c6d0fa4597af
     # @param agent_id [Integer]
-    # @return [Qismo::SingleObject]
+    # @return [Qismo::Objects::User]
     def agent(agent_id)
-      get("/api/v2/admin/agent/#{agent_id}").data.agent
+      Qismo::Objects::User.new(get("/api/v2/admin/agent/#{agent_id}").data.agent)
     end
 
     # Get office hour config
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#6f3f0cb0-a391-4945-b01a-95ce81138913
-    # @return [Qismo::SingleObject]
+    # @return [Qismo::Objects::OfficeHour]
     def office_hours
-      data = get("/api/v1/admin/office_hours").data
-      data_hash = data.as_json
-      data_hash["is_in_office_hour"] = Util.in_office_hour?(data)
-
-      SingleObject.new(data_hash)
+      Qismo::Objects::OfficeHour.new(
+        get("/api/v1/admin/office_hours").data
+      )
     end
 
     # List WA broadcast templates
@@ -357,32 +481,76 @@ module Qismo
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#e38d2244-9559-4015-99d5-8c707f6c01bd
     # @param options [Hash]
     # @return [Qismo::CollectionObject]
-    def wa_broadcast_templates(options = {})
-      body = get("/api/v3/admin/hsm", options)
-
-      meta = body.meta
-      next_page = (meta.page < meta.total_page) ? (meta.page + 1) : nil
-      prev_page = (meta.page > 1) ? (meta.page - 1) : nil
-
-      CollectionObject.new(
-        body.data.hsm_templates,
-        next_page: next_page,
-        prev_page: prev_page,
-        next_func: -> { wa_broadcast_templates(options.merge(page: next_page)) },
-        prev_func: -> { wa_broadcast_templates(options.merge(page: prev_page)) }
+    def wa_broadcast_templates(page: 1, limit: 10, approved: nil)
+      body = get("/api/v3/admin/hsm", {
+        page: page,
+        limit: limit,
+        approved: approved
+      })
+
+      Qismo::Collection.new(
+        Qismo::Objects::HsmTemplate.from_array(body.data.hsm_templates),
+        next_page: ((body.meta.page < body.meta.total_page) ? (body.meta.page + 1) : nil),
+        prev_page: ((body.meta.page > 1) ? (body.meta.page - 1) : nil)
       )
     end
 
     alias_method :wa_message_templates, :wa_broadcast_templates
     alias_method :wa_outbound_templates, :wa_broadcast_templates
 
+    # Get Whatsapp channel credit info
+    #
+    # @return [Qismo::Objects::WaCreditInfo]
+    def wa_credit
+      Qismo::Objects::WaCreditInfo.new(
+        get("/api/v2/admin/wa_pricing/balance").data
+      )
+    end
+
     # Send WA outbound message
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#d0183cf6-deca-439b-aff3-2e2f007c15a9
-    # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def send_wa_outbound(options = {})
-      post("/api/v3/admin/broadcast/client", options).data
+    # @param phone_number [String]
+    # @param channel_id [Integer]
+    # @param template_name [String]
+    # @param namespace [String]
+    # @param language [String]
+    # @param template_detail_id [Integer]
+    # @param variables [Array<String>]
+    # @param button_params [Array<Hash>]
+    # @param header_value [Hash]
+    # @return [Qismo::Objects::BroadcastJob]
+    def send_wa_outbound(
+      phone_number:,
+      template_detail_id: nil,
+      channel_id: nil,
+      template_name: nil,
+      namespace: nil,
+      language: nil,
+      variables: [],
+      button_params: nil,
+      header_value: nil
+    )
+      if template_detail_id.nil?
+        raise ArgumentError, ":channel_id is required if you dont use :template_detail_id" if channel_id.nil?
+        raise ArgumentError, ":template_name is required if you dont use :template_detail_id" if template_name.nil?
+        raise ArgumentError, ":namespace is required if you dont use :template_detail_id" if namespace.nil?
+        raise ArgumentError, ":language is required if you dont use :template_detail_id" if language.nil?
+      end
+
+      body = post("/api/v3/admin/broadcast/client", {
+        phone_number: phone_number,
+        template_detail_id: template_detail_id,
+        channel_id: channel_id,
+        template_name: template_name,
+        namespace: namespace,
+        language: language,
+        variables: variables,
+        button_params: button_params,
+        header_value: header_value
+      })
+
+      Qismo::Objects::BroadcastJob.new(body.data)
     end
 
     # Upload wa broadcast file that want to be sent in broadcast
@@ -390,20 +558,58 @@ module Qismo
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#030acde2-21cf-4373-8d11-075206053c1d
     # @param file [HTTP::FormData]
     # @param template_detail_id [Integer]
-    # @return [Qismo::SingleObject]
-    def upload_wa_broadcast_csv(file, template_detail_id)
+    # @return [Integer]
+    def upload_wa_broadcast_csv(file, template_detail_id, separator: ",")
       raise ArgumentError, "Invalid file" unless file.is_a?(HTTP::FormData::File)
 
-      post_upload("/api/v3/admin/broadcast/upload_csv", file: file, template_detail_id: template_detail_id)
+      body = post_upload("/api/v3/admin/broadcast/upload_csv", {
+        file: file,
+        template_detail_id: template_detail_id,
+        separator: separator
+      })
+
+      body.broadcast_file_id
     end
 
-    # Send wa broadcast
+    # Send WA broadcast
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#717c1a12-facb-4945-aed5-04557696b873
-    # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def send_wa_broadcast(options = {})
-      post("/api/v3/admin/broadcast/send_broadcast", options).data.broadcast_job
+    # @param file [HTTP::FormData::File,Integer]
+    # @param template_detail_id [Integer]
+    # @param name [String]
+    # @param separator [String]
+    # @param started_at [Time]
+    # @return [Qismo::Objects::BroadcastJob]
+    def send_wa_broadcast(file, template_detail_id, name: nil, separator: ",", started_at: nil)
+      if name.blank?
+        name = default_broadcast_name
+      end
+
+      if started_at.present? && !started_at.is_a?(Time)
+        unless started_at.is_a?(Time)
+          raise ArgumentError, "You must past :Time class for this parameter"
+        end
+
+        unless started_at.utc_offset == 0
+          raise ArgumentError, "You must set your timezone to UTC"
+        end
+      end
+
+      file_id = if file.is_a?(HTTP::FormData::File)
+        upload_wa_broadcast_csv(file, template_detail_id, separator: separator)
+      else
+        file.to_i
+      end
+
+      Qismo::Objects::BroadcastJob.new(
+        post("/api/v3/admin/broadcast/send_broadcast", {
+          broadcast_file_id: file_id,
+          name: name,
+          separator: separator,
+          started_at: started_at,
+          template_detail_id: template_detail_id
+        }).data.broadcast_job
+      )
     end
 
     alias_method :create_wa_broadcast, :send_wa_broadcast
@@ -413,18 +619,27 @@ module Qismo
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#3a4caa8b-eef4-427f-adcb-d065989899c9
     # @param options [Hash]
     # @return [Qismo::CollectionObject]
-    def wa_broadcast_jobs(options = {})
-      body = get("/api/v2/admin/broadcast_jobs", options)
-
-      prev_page = (body.meta.page > 1) ? (body.meta.meta - 1) : nil
-      next_page = (body.meta.page < body.meta.total_page) ? (body.meta.page + 1) : nil
 
-      CollectionObject.new(
-        body.data.broadcast_jobs,
-        next_page: next_page,
-        prev_page: prev_page,
-        next_func: -> { wa_broadcast_jobs(options.merge(page: next_page)) },
-        prev_func: -> { wa_broadcast_jobs(options.merge(page: prev_page)) }
+    # List WA broadcast jobs
+    #
+    # @param page [Integer]
+    # @param limit [Integer]
+    # @param cursor_after [Integer]
+    # @param cursor_before [Integer]
+    # @param name [String]
+    # @return [Qismo::Collection<Qismo::Objects::BroadcastJob>]
+    def wa_broadcast_jobs(limit: 10, cursor_after: nil, cursor_before: nil, name: nil)
+      body = get("/api/v2/admin/broadcast_jobs", {
+        limit: limit,
+        cursor_after: cursor_after,
+        cursor_before: cursor_before,
+        name: name
+      })
+
+      Qismo::Collection.new(
+        Qismo::Objects::BroadcastJob.from_array(body.data.broadcast_jobs),
+        next_page: body.meta.cursor_after,
+        prev_page: body.meta.cursor_before
       )
     end
 
@@ -432,9 +647,11 @@ module Qismo
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#ed0806c8-2e4a-4ea4-8acb-45c84c63c2da
     # @param broadcast_job_id [Integer]
-    # @return [Qismo::SingleObject]
+    # @return [Qismo::Objects::BroadcastJob]
     def wa_broadcast_job(broadcast_job_id)
-      get("/api/v2/admin/broadcast_jobs/#{broadcast_job_id}").data.broadcast_job
+      Qismo::Objects::BroadcastJob.new(
+        get("/api/v2/admin/broadcast_jobs/#{broadcast_job_id}").data.broadcast_job
+      )
     end
 
     # List wa broadcast logs
@@ -443,28 +660,45 @@ module Qismo
     # @param broadcast_job_id [Integer]
     # @param options [Hash]
     # @return [Qismo::CollectionObject]
-    def wa_broadcast_logs(broadcast_job_id, options = {})
-      body = get("/api/v2/admin/broadcast_logs/#{broadcast_job_id}", options)
+    def wa_broadcast_logs(broadcast_job_id, page: 1, limit: 10)
+      body = get("/api/v2/admin/broadcast_logs/#{broadcast_job_id}", {
+        page: page,
+        limit: limit
+      })
 
       prev_page = (body.meta.page > 1) ? (body.meta.meta - 1) : nil
       next_page = (body.meta.page < body.meta.total_page) ? (body.meta.page + 1) : nil
 
-      CollectionObject.new(
-        body.data.broadcast_logs,
+      Qismo::Collection.new(
+        Qismo::Objects::BroadcastLog.from_array(body.data.broadcast_logs),
         next_page: next_page,
-        prev_page: prev_page,
-        next_func: -> { wa_broadcast_logs(options.merge(page: next_page)) },
-        prev_func: -> { wa_broadcast_jobs(options.merge(page: prev_page)) }
+        prev_page: prev_page
       )
     end
 
     # Send message as bot
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#bb77c653-5daa-4e1c-a866-43bca7c494fc
-    # @param options [Hash]
+    # @param room_id [Integer]
+    # @param message [String]
+    # @param type [String]
+    # @param payload [Hash]
+    # @param extras [Hash]
     # @return [TrueClass]
-    def send_bot_message(options = {})
-      post("#{app_id}/bot", options)
+    def send_bot_message(room_id, message, type: "text", payload: {}, extras: {})
+      body = post("/#{app_id}/bot", {
+        sender_email: admin_email,
+        room_id: room_id.to_s,
+        message: message,
+        type: type,
+        payload: payload,
+        extras: extras
+      })
+
+      if body != "ok"
+        raise Qismo::BadRequestError.new(body.to_s, status_code: 400, response_body: body.to_s)
+      end
+
       true
     end
 
@@ -494,7 +728,10 @@ module Qismo
     # @param room_id [Integer]
     # @return [TrueClass]
     def handover_room_from_bot(room_id)
-      post("/#{app_id}/bot/#{room_id}/hand_over")
+      request(:post, "/#{app_id}/bot/#{room_id}/hand_over", headers: {
+        Authorization: secret_key
+      })
+
       true
     end
 
@@ -505,8 +742,33 @@ module Qismo
     # @param roles [Array<Integer>]
     # @param options [Hash]
     # @return [TrueClass]
-    def handover_room_from_bot_to_division(room_id, roles, options = {})
-      post("/#{app_id}/bot/#{room_id}/hand_over_to_role", options.merge(roles: roles))
+
+    # Handover room from chatbot to human agent in specific divisions
+    #
+    # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#8218db08-9753-4d74-ae5f-0ee62f8579b9# <Description>
+    #
+    # @param room_id [Integer]
+    # @param role [Integer,Array<Integer>]
+    # @param find_online_agent [TrueClass,FalseClass]
+    # @return [TrueClass,FalseClass]
+    def handover_room_from_bot_to_division(room_id, role, find_online_agent: true)
+      options = {}
+      options[:room_id] = room_id.to_s
+      options[:find_online_agent] = find_online_agent
+
+      if role.is_a?(Array)
+        options[:roles] = role
+      else
+        options[:role] = role
+      end
+
+      request(
+        :post,
+        "/#{app_id}/bot/#{room_id}/hand_over_to_role",
+        headers: {Authorization: secret_key},
+        json: options
+      )
+
       true
     end
 
@@ -519,7 +781,7 @@ module Qismo
     # @return [Qismo::SingleObject]
     def initiate_widget_chat(user_id, name, options = {})
       options = options.merge(app_id: app_id, user_id: user_id, name: name)
-      post("/api/v2/qiscus/initiate_chat", options).data.customer_room
+      Qismo::Objects::CustomerRoom.new(post("/api/v2/qiscus/initiate_chat", options).data.customer_room)
     end
 
     alias_method :initiate_chat, :initiate_widget_chat
@@ -532,78 +794,49 @@ module Qismo
     # @param name [String]
     # @param options [Hash]
     # @return [Qismo::SingleObject]
-    def send_message_to_custom_channel(identifier_key, user_id, name, options = {})
-      post("/#{app_id}/api/v2/custom_channel/send",
-        options.merge(identifier_key: identifier_key, user_id: user_id, name: name)).data
-    end
 
-    # List integrated channels
+    # Send messsage to custom channel
     #
     # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#aee54b21-68f1-4d31-9d81-d3c73b3e125b
-    # @return [Qismo::SingleObject]
-    def channels
-      get("/api/v2/channels").data
-    end
-
-    # Create customchannel
-    #
     # @param identifier_key [String]
+    # @param user_id [String]
     # @param name [String]
-    # @param webhook_url [String]
-    # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def create_custom_channel(identifier_key, name, webhook_url, options = {})
-      options = options.merge(
-        identifier_key: identifier_key,
-        name: name,
-        webhook_url: webhook_url
+    # @param message [String]
+    # @param avatar [String]
+    # @param type [String]
+    # @param payload [Hash]
+    # @param extras [Hash]
+    # @return [Qismo::Objects::CustomChannelMessageResponse]
+    def send_message_to_custom_channel(
+      identifier_key,
+      user_id,
+      name,
+      message,
+      avatar: nil,
+      type: "text",
+      payload: {},
+      extras: {}
+    )
+      Qismo::Objects::CustomChannelMessageResponse.new(
+        post("/#{app_id}/api/v2/custom_channel/send", {
+          identifier_key: identifier_key,
+          user_id: user_id,
+          name: name,
+          message: message,
+          avatar: avatar,
+          type: type,
+          payload: payload,
+          extras: extras
+        }).data
       )
-
-      options[:is_active] = true unless options[:is_active].nil?
-
-      post("/api/v1/custom_channel/connect", options.merge).data
-    end
-
-    # Update custom channel
-    #
-    # @param id [Integer]
-    # @param options [Hash]
-    # @return [Qismo::SingleObject]
-    def update_custom_channel(id, options = {})
-      channel = channels.custom_channels.find { |cc| cc.id == id }
-      if channel.nil?
-        raise Qismo::NotFoundError.new("Channel not found", status_code: 404, response_body: nil)
-      end
-
-      channel_hash = JSON.parse(channel.to_json, symbolize_names: true)
-      new_channel_config = channel_hash.merge(options)
-
-      post("/api/v1/custom_channel/connect/update", new_channel_config).data
-    end
-
-    # Activate custom channel
-    #
-    # @param id [Integer]
-    # @return [Qismo::SingleObject]
-    def activate_custom_channel(id)
-      update_custom_channel(id, is_active: true)
-    end
-
-    # Deactivate custom channel
-    #
-    # @param id [Integer]
-    # @return [Qismo::SingleObject]
-    def deactivate_custom_channel(id)
-      update_custom_channel(id, is_active: false)
     end
 
-    # Delete custom channel
+    # List integrated channels
     #
-    # @param id [Integer]
-    # @return [TrueClass]
-    def delete_custom_channel(id)
-      post("/api/v2/custom_channel/connect/#{id}/delete")
-      true
+    # @see https://documenter.getpostman.com/view/8259884/TVsuCSeT#aee54b21-68f1-4d31-9d81-d3c73b3e125b
+    # @return [Qismo::ObjectifiedHash]
+    def channels
+      get("/api/v2/channels").data
     end
   end
 end