kapso-client-ruby 1.0.0 → 1.0.2

data/Rakefile

@@ -1,41 +1,41 @@
-# frozen_string_literal: true
-
-desc 'Run RSpec tests'
-task :spec do
-  sh 'bundle exec rspec'
-end
-
-desc 'Run RuboCop'
-task :rubocop do
-  sh 'bundle exec rubocop'
-end
-
-desc 'Run all linting and tests'
-task test: [:rubocop, :spec]
-
-desc 'Generate YARD documentation'
-task :docs do
-  sh 'bundle exec yard doc'
-end
-
-desc 'Clean up generated files'
-task :clean do
-  sh 'rm -rf coverage/ doc/ .yardoc/'
-end
-
-desc 'Build the gem'
-task :build do
-  sh 'gem build kapso-client-ruby.gemspec'
-end
-
-desc 'Install the gem locally'
-task install: :build do
-  sh 'gem install kapso-client-ruby-*.gem'
-end
-
-desc 'Release the gem'
-task release: [:clean, :test, :build] do
-  puts 'Run `gem push kapso-client-ruby-*.gem` to release'
-end
-
+# frozen_string_literal: true
+
+desc 'Run RSpec tests'
+task :spec do
+  sh 'bundle exec rspec'
+end
+
+desc 'Run RuboCop'
+task :rubocop do
+  sh 'bundle exec rubocop'
+end
+
+desc 'Run all linting and tests'
+task test: [:rubocop, :spec]
+
+desc 'Generate YARD documentation'
+task :docs do
+  sh 'bundle exec yard doc'
+end
+
+desc 'Clean up generated files'
+task :clean do
+  sh 'rm -rf coverage/ doc/ .yardoc/'
+end
+
+desc 'Build the gem'
+task :build do
+  sh 'gem build kapso-client-ruby.gemspec'
+end
+
+desc 'Install the gem locally'
+task install: :build do
+  sh 'gem install kapso-client-ruby-*.gem'
+end
+
+desc 'Release the gem'
+task release: [:clean, :test, :build] do
+  puts 'Run `gem push kapso-client-ruby-*.gem` to release'
+end
+
 task default: :test

data/TEMPLATE_TOOLS_GUIDE.md

@@ -1,121 +1,121 @@
-# 📋 Kapso Template Management Tools
-
-## The 24-Hour Problem & Solution
-
-**Problem**: You're getting "24 hours have passed" errors when sending messages.  
-**Solution**: Use template messages - they work anytime, no 24-hour limit!
-
-## 🛠️ Template Tools (Simplified)
-
-### 1. `scripts/kapso_template_finder.rb` - **MAIN TOOL** ⭐
-```bash
-ruby scripts/kapso_template_finder.rb
-```
-**Purpose**: Complete template discovery and testing  
-**Features**: 
-- Fetches your actual created templates from Kapso
-
-### 2. `scripts/test.rb` - Basic Message Testing
-```bash  
-ruby scripts/test.rb
-```
-**Purpose**: Test regular message sending  
-**Use when**: Testing within 24-hour window  
-**Features**:
-- Test regular messages 
-- Shows 24h error if outside window
-
-## 📋 Setup Instructions
-
-### Step 1: Find Your Business Account ID
-
-1. **Login to Kapso Dashboard**: https://app.kapso.ai/
-2. **Navigate to WhatsApp Business section**
-3. **Look for**:
-   - "Business Account ID"
-   - "WABA ID" 
-   - Long number (15+ digits)
-4. **Add to `.env` file**:
-   ```properties
-   BUSINESS_ACCOUNT_ID=your_business_account_id_here
-   ```
-
-### Step 2: Discover Your Templates
-
-```bash
-ruby scripts/kapso_template_finder.rb
-```
-
-✅ **Current Status**: Found 1 template `reply_message (es_MX) - PENDING`  
-⏳ **Waiting for approval** - Template will work once Meta approves it
-
-### Step 3: Test Templates
-
-```bash
-ruby test_specific_template.rb
-# Enter template name when prompted
-```
-
-## 🎯 Creating Templates in Kapso
-
-### Via Kapso Dashboard:
-1. Login to https://app.kapso.ai/
-2. Find "WhatsApp Templates" or "Template Builder"
-3. Create simple text template:
-   - **Name**: `hello_world` or `welcome_message`
-   - **Language**: `en_US`  
-   - **Category**: `UTILITY` (usually fastest approval)
-   - **Content**: "Hello {{1}}, welcome to our service!"
-
-### Template Approval:
-- **Pending**: Template submitted, waiting for Meta approval
-- **Approved**: Ready to use anytime  
-- **Rejected**: Need to fix and resubmit
-- **Time**: Usually 24-48 hours for approval
-
-## 🚀 Using Templates in Code
-
-```ruby
-# Once your template is approved:
-response = client.messages.send_template(
-  phone_number_id: "your_phone_number",
-  to: "+56912345678", 
-  name: "reply_message",      # Your actual template name
-  language: "es_MX"           # Your template language
-)
-
-# Templates work 24/7 - no time restrictions!
-```
-
-## 🔄 Workflow Summary
-
-1. **Check templates**: `ruby scripts/kapso_template_finder.rb`
-2. ✅ **Template found**: `reply_message (es_MX) - PENDING`
-3. ⏳ **Wait for approval**: Meta is reviewing your template  
-4. **Once approved**: Use `reply_message` template for 24/7 messaging
-
-## ❓ Troubleshooting
-
-### "Template not found"
-- Template name is wrong
-- Template not approved yet
-- Language code incorrect
-
-### "24 hours error" (with templates)
-- This shouldn't happen with templates
-- Contact Kapso support
-
-### "Business Account ID not found"
-- Check Kapso dashboard for WABA ID
-- Add to .env file
-- Contact Kapso support if unclear
-
-## 📞 Support Resources
-
-- **Kapso Dashboard**: https://app.kapso.ai/
-- **Kapso Support**: Contact through dashboard
-- **WhatsApp Template Policies**: Check Meta Business documentation
-
----
-
+# 📋 Kapso Template Management Tools
+
+## The 24-Hour Problem & Solution
+
+**Problem**: You're getting "24 hours have passed" errors when sending messages.  
+**Solution**: Use template messages - they work anytime, no 24-hour limit!
+
+## 🛠️ Template Tools (Simplified)
+
+### 1. `scripts/kapso_template_finder.rb` - **MAIN TOOL** ⭐
+```bash
+ruby scripts/kapso_template_finder.rb
+```
+**Purpose**: Complete template discovery and testing  
+**Features**: 
+- Fetches your actual created templates from Kapso
+
+### 2. `scripts/test.rb` - Basic Message Testing
+```bash  
+ruby scripts/test.rb
+```
+**Purpose**: Test regular message sending  
+**Use when**: Testing within 24-hour window  
+**Features**:
+- Test regular messages 
+- Shows 24h error if outside window
+
+## 📋 Setup Instructions
+
+### Step 1: Find Your Business Account ID
+
+1. **Login to Kapso Dashboard**: https://app.kapso.ai/
+2. **Navigate to WhatsApp Business section**
+3. **Look for**:
+   - "Business Account ID"
+   - "WABA ID" 
+   - Long number (15+ digits)
+4. **Add to `.env` file**:
+   ```properties
+   BUSINESS_ACCOUNT_ID=your_business_account_id_here
+   ```
+
+### Step 2: Discover Your Templates
+
+```bash
+ruby scripts/kapso_template_finder.rb
+```
+
+✅ **Current Status**: Found 1 template `reply_message (es_MX) - PENDING`  
+⏳ **Waiting for approval** - Template will work once Meta approves it
+
+### Step 3: Test Templates
+
+```bash
+ruby test_specific_template.rb
+# Enter template name when prompted
+```
+
+## 🎯 Creating Templates in Kapso
+
+### Via Kapso Dashboard:
+1. Login to https://app.kapso.ai/
+2. Find "WhatsApp Templates" or "Template Builder"
+3. Create simple text template:
+   - **Name**: `hello_world` or `welcome_message`
+   - **Language**: `en_US`  
+   - **Category**: `UTILITY` (usually fastest approval)
+   - **Content**: "Hello {{1}}, welcome to our service!"
+
+### Template Approval:
+- **Pending**: Template submitted, waiting for Meta approval
+- **Approved**: Ready to use anytime  
+- **Rejected**: Need to fix and resubmit
+- **Time**: Usually 24-48 hours for approval
+
+## 🚀 Using Templates in Code
+
+```ruby
+# Once your template is approved:
+response = client.messages.send_template(
+  phone_number_id: "your_phone_number",
+  to: "+56912345678", 
+  name: "reply_message",      # Your actual template name
+  language: "es_MX"           # Your template language
+)
+
+# Templates work 24/7 - no time restrictions!
+```
+
+## 🔄 Workflow Summary
+
+1. **Check templates**: `ruby scripts/kapso_template_finder.rb`
+2. ✅ **Template found**: `reply_message (es_MX) - PENDING`
+3. ⏳ **Wait for approval**: Meta is reviewing your template  
+4. **Once approved**: Use `reply_message` template for 24/7 messaging
+
+## ❓ Troubleshooting
+
+### "Template not found"
+- Template name is wrong
+- Template not approved yet
+- Language code incorrect
+
+### "24 hours error" (with templates)
+- This shouldn't happen with templates
+- Contact Kapso support
+
+### "Business Account ID not found"
+- Check Kapso dashboard for WABA ID
+- Add to .env file
+- Contact Kapso support if unclear
+
+## 📞 Support Resources
+
+- **Kapso Dashboard**: https://app.kapso.ai/
+- **Kapso Support**: Contact through dashboard
+- **WhatsApp Template Policies**: Check Meta Business documentation
+
+---
+
 **Remember**: Templates solve the 24-hour limitation permanently! Regular messages work within 24h of customer reply, templates work anytime. 🎯

data/WHATSAPP_24_HOUR_GUIDE.md

@@ -1,134 +1,134 @@
-# WhatsApp 24-Hour Window Policy - Solutions Guide
-
-## The Problem You're Experiencing
-
-**Error Message**: "Meta reported a deli### Long-term**: Design your messaging strategy around the 24h rule
-
-## Kapso.ai Specific Features
-
-Since you're using Kapso.ai, you may have access to:
-
-- **Template Library**: Pre-built approved templates
-- **Template Builder**: Easy template creation interface  
-- **Auto-Approval**: Faster template approval process
-- **Template Analytics**: Usage statistics and delivery rates
-- **Bulk Template Management**: Manage multiple templates
-
-Check your Kapso dashboard for:
-1. **Available Templates** - Already approved and ready to use
-2. **Template Status** - Pending, approved, or rejected templates
-3. **Template Builder** - Create new templates without Meta Business Manager
-
-## Why This Existsy error. Re-engagement message Message failed to send because more than 24 hours have passed since the customer last replied to this number."
-
-This is **NOT** a bug in your Ruby SDK - it's a WhatsApp Business API policy.
-
-## Understanding the 24-Hour Rule
-
-WhatsApp Business API has a **conversation window** policy:
-
-### ✅ Within 24 Hours (Free Messaging Window)
-- **Trigger**: Customer sends you a message
-- **Duration**: 24 hours from their last message
-- **Allowed**: ANY message type (text, images, audio, video, documents)
-- **No restrictions**: Send as many messages as you want
-
-### ❌ After 24 Hours (Template-Only Window)  
-- **Trigger**: 24+ hours since customer's last message
-- **Restriction**: ONLY pre-approved template messages allowed
-- **Regular messages**: Will be rejected with your error
-
-## Solutions
-
-### Option 1: Use Template Messages (Recommended)
-
-Template messages work anytime and are designed for business communications:
-
-```ruby
-# Send a template message (works 24/7)
-response = client.messages.send_template(
-  phone_number_id: phone_number_id,
-  to: "+56912345678",
-  template_name: "hello_world",  # Must be pre-approved
-  template_language: "en_US"
-)
-```
-
-### Option 2: Wait for Customer Reply
-
-- Customer sends any message → Opens 24-hour window
-- You can then send regular messages for 24 hours
-
-### Option 3: Create Templates via Kapso.ai
-
-✅ **Current Status**: You already have templates in progress!
-
-1. **Kapso Dashboard**: ✅ Connected (Business Account: `your_business_id_account`)
-2. **Template Found**: `reply_message (es_MX) - PENDING`
-3. **Status**: Waiting for Meta approval (usually 24-48 hours)
-4. **Once Approved**: Use `your_template` template for 24/7 messaging
-5. **Test Tool**: `ruby scripts/kapso_template_finder.rb`
-
-## Prevention Strategies
-
-### For Customer Service
-- Respond within 24 hours of customer messages
-- Use templates for follow-ups after 24h
-- Set up auto-responses within the window
-
-### For Marketing  
-- Always use approved template messages
-- Create templates for different campaigns
-- Schedule template sends anytime
-
-### For Notifications
-- Use templates for order updates, reminders, etc.
-- Create templates for common notifications
-- Test templates before going live
-
-## Template Message Examples
-
-### Basic Template (No Variables)
-```ruby
-client.messages.send_template(
-  phone_number_id: phone_number_id,
-  to: phone_number,
-  template_name: "hello_world",
-  template_language: "en_US"
-)
-```
-
-### Template with Variables
-```ruby
-client.messages.send_template(
-  phone_number_id: phone_number_id,
-  to: phone_number,
-  template_name: "order_confirmation",
-  template_language: "en_US",
-  components: [
-    {
-      type: "body",
-      parameters: [
-        { type: "text", text: "John" },      # Customer name
-        { type: "text", text: "12345" }     # Order number
-      ]
-    }
-  ]
-)
-```
-
-## Next Steps
-
-1. **Immediate**: Use `ruby template_test.rb` to test template messages
-2. **Short-term**: Create templates in Meta Business Manager
-3. **Long-term**: Design your messaging strategy around the 24h rule
-
-## Why This Exists
-
-WhatsApp enforces this to:
-- Prevent spam
-- Ensure quality business communications  
-- Protect user experience
-- Maintain platform integrity
-
+# WhatsApp 24-Hour Window Policy - Solutions Guide
+
+## The Problem You're Experiencing
+
+**Error Message**: "Meta reported a deli### Long-term**: Design your messaging strategy around the 24h rule
+
+## Kapso.ai Specific Features
+
+Since you're using Kapso.ai, you may have access to:
+
+- **Template Library**: Pre-built approved templates
+- **Template Builder**: Easy template creation interface  
+- **Auto-Approval**: Faster template approval process
+- **Template Analytics**: Usage statistics and delivery rates
+- **Bulk Template Management**: Manage multiple templates
+
+Check your Kapso dashboard for:
+1. **Available Templates** - Already approved and ready to use
+2. **Template Status** - Pending, approved, or rejected templates
+3. **Template Builder** - Create new templates without Meta Business Manager
+
+## Why This Existsy error. Re-engagement message Message failed to send because more than 24 hours have passed since the customer last replied to this number."
+
+This is **NOT** a bug in your Ruby SDK - it's a WhatsApp Business API policy.
+
+## Understanding the 24-Hour Rule
+
+WhatsApp Business API has a **conversation window** policy:
+
+### ✅ Within 24 Hours (Free Messaging Window)
+- **Trigger**: Customer sends you a message
+- **Duration**: 24 hours from their last message
+- **Allowed**: ANY message type (text, images, audio, video, documents)
+- **No restrictions**: Send as many messages as you want
+
+### ❌ After 24 Hours (Template-Only Window)  
+- **Trigger**: 24+ hours since customer's last message
+- **Restriction**: ONLY pre-approved template messages allowed
+- **Regular messages**: Will be rejected with your error
+
+## Solutions
+
+### Option 1: Use Template Messages (Recommended)
+
+Template messages work anytime and are designed for business communications:
+
+```ruby
+# Send a template message (works 24/7)
+response = client.messages.send_template(
+  phone_number_id: phone_number_id,
+  to: "+56912345678",
+  template_name: "hello_world",  # Must be pre-approved
+  template_language: "en_US"
+)
+```
+
+### Option 2: Wait for Customer Reply
+
+- Customer sends any message → Opens 24-hour window
+- You can then send regular messages for 24 hours
+
+### Option 3: Create Templates via Kapso.ai
+
+✅ **Current Status**: You already have templates in progress!
+
+1. **Kapso Dashboard**: ✅ Connected (Business Account: `your_business_id_account`)
+2. **Template Found**: `reply_message (es_MX) - PENDING`
+3. **Status**: Waiting for Meta approval (usually 24-48 hours)
+4. **Once Approved**: Use `your_template` template for 24/7 messaging
+5. **Test Tool**: `ruby scripts/kapso_template_finder.rb`
+
+## Prevention Strategies
+
+### For Customer Service
+- Respond within 24 hours of customer messages
+- Use templates for follow-ups after 24h
+- Set up auto-responses within the window
+
+### For Marketing  
+- Always use approved template messages
+- Create templates for different campaigns
+- Schedule template sends anytime
+
+### For Notifications
+- Use templates for order updates, reminders, etc.
+- Create templates for common notifications
+- Test templates before going live
+
+## Template Message Examples
+
+### Basic Template (No Variables)
+```ruby
+client.messages.send_template(
+  phone_number_id: phone_number_id,
+  to: phone_number,
+  template_name: "hello_world",
+  template_language: "en_US"
+)
+```
+
+### Template with Variables
+```ruby
+client.messages.send_template(
+  phone_number_id: phone_number_id,
+  to: phone_number,
+  template_name: "order_confirmation",
+  template_language: "en_US",
+  components: [
+    {
+      type: "body",
+      parameters: [
+        { type: "text", text: "John" },      # Customer name
+        { type: "text", text: "12345" }     # Order number
+      ]
+    }
+  ]
+)
+```
+
+## Next Steps
+
+1. **Immediate**: Use `ruby template_test.rb` to test template messages
+2. **Short-term**: Create templates in Meta Business Manager
+3. **Long-term**: Design your messaging strategy around the 24h rule
+
+## Why This Exists
+
+WhatsApp enforces this to:
+- Prevent spam
+- Ensure quality business communications  
+- Protect user experience
+- Maintain platform integrity
+
 The Ruby SDK is working perfectly - this is just how WhatsApp Business API works! 🚀