feat: endpoint sending messages by phone numbers

refs https://developers.line.biz/en/reference/partner-docs/#phone-audience-match

Author: Sean0628

lib/line/bot/client.rb

@@ -1174,6 +1174,26 @@ def get_narrowcast_message_status(request_id)
         get(endpoint, endpoint_path, credentials)
       end
 
+      # Send messages to multiple users using phone numbers.
+      #
+      # @param to [Array, String] Array of hashed phone numbers
+      # @param messages [Hash, Array] Message Objects
+      # @param headers [Hash] HTTP Headers
+      # @param payload [Hash] Additional request body
+      #
+      # @return [Net::HTTPResponse]
+
+      def multicast_by_phone_numbers(to, messages, headers: {}, payload: {})
+        channel_token_required
+
+        to = [to] if to.is_a?(String)
+        messages = [messages] if messages.is_a?(Hash)
+
+        endpoint_path = 'bot/ad/multicast/phone'
+        payload = payload.merge({ to: to, messages: messages }).to_json
+        post(oauth_endpoint, endpoint_path, payload, credentials.merge(headers))
+      end
+
       # Fetch data, get content of specified URL.
       #
       # @param endpoint_base [String]

spec/line/bot/send_message_by_phone_number_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require 'webmock/rspec'
+
+describe Line::Bot::Client do
+  before do
+    uri_template = Addressable::Template.new Line::Bot::API::DEFAULT_OAUTH_ENDPOINT + 'bot/ad/multicast/phone'
+    stub_request(:post, uri_template).to_return { |request| { body: '{}', status: 200 } }
+  end
+
+  let(:client)  do
+    Line::Bot::Client.new do |config|
+      config.channel_token = 'channel_token'
+    end
+  end
+  let(:phone_numbers) { ['818000000000', '817000000000'].map { Digest::SHA256.hexdigest(_1) } }
+  let(:message) do
+    {
+      type: 'text',
+      text: 'Hello, world'
+    }
+  end
+
+  context 'normal scenario' do
+    it 'pushes the message' do
+      response = client.multicast_by_phone_numbers(phone_numbers, message)
+
+      expect(response.body).to eq('{}')
+    end
+  end
+
+  context 'with additional payload' do
+    it 'pushes the message' do
+      response = client.multicast_by_phone_numbers(phone_numbers, message, payload: { notificationDisabled: true })
+
+      expect(response.body).to eq('{}')
+    end
+  end
+end