flow_chat 0.3.0 → 0.4.1

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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flow_chat
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Stefan Froelich
@@ -97,15 +97,26 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- examples/initializer.rb
+- examples/media_prompts_examples.rb
+- examples/multi_tenant_whatsapp_controller.rb
+- examples/ussd_controller.rb
+- examples/whatsapp_controller.rb
+- examples/whatsapp_media_examples.rb
+- examples/whatsapp_message_job.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/simulator/controller.rb
+- lib/flow_chat/simulator/views/simulator.html.erb
 - lib/flow_chat/ussd/app.rb
 - lib/flow_chat/ussd/gateway/nalo.rb
 - lib/flow_chat/ussd/gateway/nsano.rb
@@ -115,9 +126,16 @@ files:
 - lib/flow_chat/ussd/processor.rb
 - lib/flow_chat/ussd/prompt.rb
 - lib/flow_chat/ussd/renderer.rb
-- 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/client.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/send_job_support.rb
+- lib/flow_chat/whatsapp/template_manager.rb
 homepage: https://github.com/radioactive-labs/flow_chat
 licenses:
 - MIT

data/lib/flow_chat/ussd/simulator/controller.rb

@@ -1,51 +0,0 @@
-module FlowChat
-  module Ussd
-    module Simulator
-      module Controller
-        def ussd_simulator
-          respond_to do |format|
-            format.html do
-              render inline: simulator_view_template, layout: false, locals: simulator_locals
-            end
-          end
-        end
-
-        protected
-
-        def show_options
-          true
-        end
-
-        def default_msisdn
-          "233200123456"
-        end
-
-        def default_endpoint
-          "/ussd"
-        end
-
-        def default_provider
-          :nalo
-        end
-
-        def simulator_view_template
-          File.read simulator_view_path
-        end
-
-        def simulator_view_path
-          File.join FlowChat.root.join("flow_chat", "ussd", "simulator", "views", "simulator.html.erb")
-        end
-
-        def simulator_locals
-          {
-            pagesize: FlowChat::Config.ussd.pagination_page_size,
-            show_options: show_options,
-            default_msisdn: default_msisdn,
-            default_endpoint: default_endpoint,
-            default_provider: default_provider
-          }
-        end
-      end
-    end
-  end
-end

data/lib/flow_chat/ussd/simulator/views/simulator.html.erb

@@ -1,239 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>FlowChat Ussd Simulator</title>
-    <style>
-      .content {
-        width: 320px;
-        margin: 100px auto;
-      }
-      .label {
-        display: inline-block;
-        width: 80px;
-        font-weight: bold;
-      }
-      .value {
-        display: inline;
-      }
-      .value select, input {
-        width: 200px;
-      }
-      .field {
-        margin: 5px;
-      }
-      #screen {
-        border: 1px black solid;
-        height:400px;
-        width:300px;
-        margin-top: 10px;
-        margin-bottom: 10px;
-        padding: 10px 5px;
-      }
-      #char-count {
-        text-align: center;
-        font-size: 10px;
-      }
-      .hidden {
-        display: none;
-      }
-    </style>
-  </head>
-  <body>
-    <div class="content">
-      <div class="field <%= show_options ? '' : 'hidden' %>">
-        <div class="label">Provider </div>
-        <div class="value">
-          <select id="provider">
-            <option <%= default_provider == :nalo ? 'selected' : '' %> value="nalo">Nalo</option>
-            <option <%= default_provider == :nsano ? 'selected' : '' %> value="nsano">Nsano</option>
-          </select>
-        </div>
-      </div>
-      <div class="field <%= show_options ? '' : 'hidden' %>">
-        <div class="label">Endpoint </div>
-        <div class="value">
-          <input id="endpoint" value="<%= default_endpoint %>" />
-        </div>
-      </div>
-      <div class="field <%= show_options ? '' : 'hidden' %>">
-        <div class="label">MSISDN </div>
-        <div class="value">
-          <input id="msisdn" value="<%= default_msisdn %>" />
-        </div>
-      </div>
-      <div id="screen"></div>
-      <div id="char-count"></div>
-      <div class="field">
-        <input id="data" disabled> <button id="respond" disabled>Respond</button>
-      </div>
-      <div class="field">
-        <button id="initiate" disabled>Initiate</button>
-        <button id="reset" disabled>Reset</button>
-      </div>
-    </div>
-    <script>
-      // Config
-      const pagesize = <%= pagesize %>
-
-      // View
-      const $screen = document.getElementById('screen')
-      const $charCount = document.getElementById('char-count')
-
-      const $provider = document.getElementById('provider')
-      const $endpoint = document.getElementById('endpoint')
-      const $msisdn = document.getElementById('msisdn')
-
-      const $data = document.getElementById('data')
-      const $respondBtn = document.getElementById('respond')
-      const $initiateBtn = document.getElementById('initiate')
-      const $resetBtn = document.getElementById('reset')
-
-      $provider.addEventListener('change', function (e) {
-        state.provider = $provider.value
-        render()
-      }, false)
-
-      $endpoint.addEventListener('keyup', function (e) {
-        state.endpoint = $endpoint.value
-        render()
-      }, false)
-
-      $msisdn.addEventListener('keyup', function (e) {
-        state.msisdn = $msisdn.value
-        render()
-      }, false)
-
-      $initiateBtn.addEventListener('click', function (e) {
-        makeRequest()
-      }, false)
-
-      $resetBtn.addEventListener('click',function(e){
-        reset()
-      }, false)
-
-      $respondBtn.addEventListener('click', function (e) {
-        makeRequest()
-      }, false)
-
-      function disableInputs() {
-        $data.disabled = 'disabled'
-        $respondBtn.disabled = 'disabled'
-        $initiateBtn.disabled = 'disabled'
-        $resetBtn.disabled = 'disabled'
-        $data.disabled = 'disabled'
-      }
-
-      function enableResponse() {
-        $data.disabled = false
-        $respondBtn.disabled = false
-        $resetBtn.disabled = false
-      }
-
-      function display(text) {
-        $screen.innerText = text.substr(0, pagesize)
-        if(text.length > 0)
-          $charCount.innerText = `${text.length} chars`
-        else
-          $charCount.innerText = ''
-      }
-
-      function render() {
-        disableInputs()
-
-        if(!state.isRunning){
-          if(state.provider && state.endpoint && state.msisdn)
-            $initiateBtn.disabled = false
-          else
-            $initiateBtn.disabled = 'disabled'
-        }
-        else {
-          enableResponse()
-        }
-      }
-
-      // State
-      const state = {}
-
-      function reset(shouldRender) {
-        state.isRunning = false
-        state.request_id = btoa(Math.random().toString()).substr(10, 10)
-        state.provider = $provider.value
-        state.endpoint = $endpoint.value
-        state.msisdn = $msisdn.value
-
-        $data.value = null
-
-        display("")
-        if(shouldRender !== false) render()
-      }
-
-
-      // API
-
-      function makeRequest() {
-        var data = {}
-
-        switch (state.provider) {
-          case "nalo":
-            data = {
-              USERID: state.request_id,
-              MSISDN: state.msisdn,
-              USERDATA: $data.value,
-              MSGTYPE: !state.isRunning,
-            }
-            break;
-          case "nsano":
-            data = {
-              network: 'MTN',
-              msisdn: state.msisdn,
-              msg: $data.value,
-              UserSessionID: state.request_id,
-            }
-            break;
-
-          default:
-            alert(`Unhandled provider request: ${state.provider}`)
-            return
-        }
-
-        disableInputs()
-        fetch(state.endpoint, {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json'
-          },
-          redirect: 'error',
-          body: JSON.stringify(data)
-        })
-          .then(response => {
-            if (!response.ok) {
-                throw Error(`${response.status}: ${response.statusText}`);
-            }
-            return response.json()
-          })
-          .then(data => {
-            switch (state.provider) {
-              case "nalo":
-                display(data.MSG)
-                state.isRunning = data.MSGTYPE
-                break;
-              case "nsano":
-                display(data.USSDResp.title)
-                state.isRunning = data.USSDResp.action == "input"
-                break;
-
-              default:
-                alert(`Unhandled provider response: ${state.provider}`)
-                return
-            }
-            $data.value = null
-          })
-          .catch(error => alert(error.message))
-          .finally(render);
-      }
-
-      // run the app
-      reset()
-    </script>
-  </body>
-</html>