flow_chat 0.2.1 → 0.4.0

data/lib/flow_chat/whatsapp/template_manager.rb

@@ -0,0 +1,162 @@
+require "net/http"
+require "json"
+
+module FlowChat
+  module Whatsapp
+    class TemplateManager
+      def initialize(config = nil)
+        @config = config || Configuration.from_credentials
+      end
+
+      # Send a template message (used to initiate conversations)
+      def send_template(to:, template_name:, language: "en_US", components: [])
+        message_data = {
+          messaging_product: "whatsapp",
+          to: to,
+          type: "template",
+          template: {
+            name: template_name,
+            language: { code: language },
+            components: components
+          }
+        }
+
+        send_message(message_data)
+      end
+
+      # Common template structures
+      def send_welcome_template(to:, name: nil)
+        components = []
+        
+        if name
+          components << {
+            type: "header",
+            parameters: [
+              {
+                type: "text",
+                text: name
+              }
+            ]
+          }
+        end
+
+        send_template(
+          to: to,
+          template_name: "hello_world", # Default Meta template
+          language: "en_US",
+          components: components
+        )
+      end
+
+      def send_notification_template(to:, message:, button_text: nil)
+        components = [
+          {
+            type: "body",
+            parameters: [
+              {
+                type: "text",
+                text: message
+              }
+            ]
+          }
+        ]
+
+        if button_text
+          components << {
+            type: "button",
+            sub_type: "quick_reply",
+            index: "0",
+            parameters: [
+              {
+                type: "payload",
+                payload: "continue"
+              }
+            ]
+          }
+        end
+
+        send_template(
+          to: to,
+          template_name: "notification_template", # Custom template
+          language: "en_US",
+          components: components
+        )
+      end
+
+      # Create a new template (requires approval from Meta)
+      def create_template(name:, category:, language: "en_US", components: [])
+        business_account_id = @config.business_account_id
+        uri = URI("https://graph.facebook.com/v18.0/#{business_account_id}/message_templates")
+        
+        template_data = {
+          name: name,
+          category: category, # AUTHENTICATION, MARKETING, UTILITY
+          language: language,
+          components: components
+        }
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Post.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+        request["Content-Type"] = "application/json"
+        request.body = template_data.to_json
+
+        response = http.request(request)
+        JSON.parse(response.body)
+      end
+
+      # List all templates
+      def list_templates
+        business_account_id = @config.business_account_id
+        uri = URI("https://graph.facebook.com/v18.0/#{business_account_id}/message_templates")
+        
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Get.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+
+        response = http.request(request)
+        JSON.parse(response.body)
+      end
+
+      # Get template status
+      def template_status(template_id)
+        uri = URI("https://graph.facebook.com/v18.0/#{template_id}")
+        
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Get.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+
+        response = http.request(request)
+        JSON.parse(response.body)
+      end
+
+      private
+
+      def send_message(message_data)
+        uri = URI(@config.messages_url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+
+        request = Net::HTTP::Post.new(uri)
+        request["Authorization"] = "Bearer #{@config.access_token}"
+        request["Content-Type"] = "application/json"
+        request.body = message_data.to_json
+
+        response = http.request(request)
+        
+        unless response.is_a?(Net::HTTPSuccess)
+          Rails.logger.error "WhatsApp Template API error: #{response.body}"
+          return nil
+        end
+
+        JSON.parse(response.body)
+      end
+    end
+  end
+end 

data/lib/flow_chat.rb

@@ -1,5 +1,6 @@
 require "zeitwerk"
 require "active_support"
+require "active_support/core_ext/time"
 
 loader = Zeitwerk::Loader.for_gem
 loader.enable_reloading if defined?(Rails.env) && Rails.env.development?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flow_chat
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Stefan Froelich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-04-05 00:00:00.000000000 Z
+date: 2025-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -89,7 +89,7 @@ extra_rdoc_files: []
 files:
 - ".DS_Store"
 - ".gitignore"
-- ".rspec"
+- ".ruby-version"
 - ".travis.yml"
 - Gemfile
 - LICENSE.txt
@@ -97,13 +97,19 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- examples/initializer.rb
+- examples/multi_tenant_whatsapp_controller.rb
+- examples/ussd_controller.rb
+- examples/whatsapp_controller.rb
 - flow_chat.gemspec
 - images/ussd_simulator.png
 - lib/flow_chat.rb
+- lib/flow_chat/base_processor.rb
 - lib/flow_chat/config.rb
 - lib/flow_chat/context.rb
 - lib/flow_chat/flow.rb
 - lib/flow_chat/interrupt.rb
+- lib/flow_chat/session/cache_session_store.rb
 - lib/flow_chat/session/middleware.rb
 - lib/flow_chat/session/rails_session_store.rb
 - lib/flow_chat/ussd/app.rb
@@ -118,6 +124,13 @@ files:
 - lib/flow_chat/ussd/simulator/controller.rb
 - lib/flow_chat/ussd/simulator/views/simulator.html.erb
 - lib/flow_chat/version.rb
+- lib/flow_chat/whatsapp/app.rb
+- lib/flow_chat/whatsapp/configuration.rb
+- lib/flow_chat/whatsapp/gateway/cloud_api.rb
+- lib/flow_chat/whatsapp/middleware/executor.rb
+- lib/flow_chat/whatsapp/processor.rb
+- lib/flow_chat/whatsapp/prompt.rb
+- lib/flow_chat/whatsapp/template_manager.rb
 homepage: https://github.com/radioactive-labs/flow_chat
 licenses:
 - MIT
@@ -141,7 +154,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Framework for building Menu based conversations (e.g. USSD) in Rails.

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper