Changelog

​

Inbox

​

Workflows

• Name: Tool identifier the agent calls
• Description: Tells the agent when to use this tool
• App integration: Select a pre-configured integration

​

Workflows

• Function name and description
• Input schema (JSON Schema)
• Full workflow execution context
• Recent flow events and WhatsApp conversation history (if applicable)

• Look up data from external APIs
• Perform calculations or transformations
• Query databases or search systems
• Integrate with any external service

​

Inbox

• Emoji reactions on individual messages
• Reply indicators showing which message is being replied to
• Sender name and preview text for replied-to messages

​

Kapso Agent

• Create, update, and delete webhooks through natural language
• Test webhook deliveries and view recent delivery logs
• Configure project-level and phone-number-level webhooks
• Set up buffering, custom headers, and retry policies

• Floating action button for quick agent access on mobile
• Full-screen mobile sheet interface
• Improved responsiveness across all screen sizes

​

API changes

{
  "type": "interactive",
  "interactive": {
    "type": "location_request_message",
    "body": {
      "text": "Please share your location"
    },
    "action": {
      "name": "send_location"
    }
  }
}

• WhatsApp API (REST and TypeScript SDK)
• Workflow builder (Send Interactive step)

​

Features

• Ad headline, body, and media
• Campaign source and click ID (ctwa_clid)
• Custom reference parameters

​

API changes

• ONE_TAP autofill: Now uses supported_apps array format (replaces deprecated package_name/signature_hash fields)
• ZERO_TAP: Added support for no-button OTP auto-read
• Button text: OTP buttons no longer accept text field (Meta generates button text)
• Validation: Added proper validation for AUTHENTICATION template structure

{
  "type": "OTP",
  "otp_type": "ONE_TAP",
  "supported_apps": [
    {
      "package_name": "com.example.app",
      "signature_hash": "K8a%2FAINcGX7"
    }
  ]
}

​

Kapso Agent

• auto - General assistant with documentation access (default)
• debugging - Health checks, error analysis, message troubleshooting
• whatsapp_templates - Template creation, submission to Meta, sending messages
• whatsapp_flow - WhatsApp Flows JSON editing, data endpoints

​

Kapso Agent

• get_project_overview - Health snapshot with connected numbers, plan status, 24h activity
• check_whatsapp_health - Token validity, messaging health, webhook status
• get_project_errors - Recent errors from message delivery, API calls, webhooks
• get_api_logs - External API call logs with status codes and response times
• get_webhook_deliveries - Webhook delivery attempts to your endpoints
• get_recent_messages - Recent WhatsApp messages with status
• get_message_details - Full message lifecycle including delivery errors
• lookup_conversation - Find conversations by phone number

​

API changes

PATCH /workflow_executions/{execution_id}

{
  "workflow_execution": {
    "status": "ended"
  }
}

​

Workflows

• interactive_chat (default) - Chat with the agent via the Workflow Chat sidebar in the inbox
• analysis_only - Agent runs non-interactively, no chat interface

​

Workflows

{
  "node_type": "send_interactive",
  "config": {
    "interactive_type": "flow",
    "body_text": "Complete checkout",
    "flow_id": "123456789012345",
    "flow_cta": "Continue",
    "flow_action": "navigate",
    "flow_action_payload": {
      "screen": "CHECKOUT",
      "data": {
        "phone_number": "{{context.phone_number}}",
        "cart_total": "{{vars.total}}"
      }
    }
  }
}

​

API changes

POST /workflow_executions/{id}/resume
{
  "message": {
    "data": "yes, proceed"
  },
  "variables": {
    "estado": "retomado",
    "user_choice": "confirmed"
  }
}

​

Workflows

{
  "node_type": "call",
  "config": {
    "workflow_id": "abc123",
    "save_error_to": "validation_error"
  }
}

​

API changes

POST /whatsapp_templates/sync

​

Workflows

{
  "parameters": [
    {
      "type": "BODY",
      "parameters": [
        { "type": "text", "text": "{{user_name}}" },
        { "type": "text", "text": "{{order_id}}" }
      ]
    }
  ]
}

​

Webhooks

{
  "message": {
    "kapso": {
      "status": "failed",
      "statuses": [
        { "status": "sent", "timestamp": "1700000000", ... },
        { "status": "delivered", "timestamp": "1700000005", ... },
        { "status": "failed", "timestamp": "1700000010", "errors": [...] }
      ]
    }
  }
}

​

API changes

{
  "data": {
    "message": "Workflow execution initiated",
    "workflow_id": "uuid",
    "id": "uuid",
    "tracking_id": "uuid"
  }
}

• GET /workflow_executions/{id} - Retrieve full execution details
• POST /workflow_executions/{id}/resume - Resume waiting executions

​

WhatsApp Flows

• Static flows - Define all content in Flow JSON, no server required
• Dynamic flows - Fetch data at runtime using Kapso Functions as your data endpoint
• Automatic encryption - Kapso handles Meta’s encryption requirements
• Response collection - Receive completions via webhooks or view in dashboard

​

Inbox

​

Workflows

• workflow.execution.handoff - Workflow handed off to human agent
• workflow.execution.failed - Workflow execution failed

​

API changes

{
  "data": [
    {
      "id": "uuid",
      "status": "running",
      "tracking_id": "uuid",
      "whatsapp_conversation_id": "uuid",
      "started_at": "2025-12-05T17:20:00Z",
      "last_event_at": "2025-12-05T17:25:00Z",
      "ended_at": null,
      "workflow": { "id": "uuid", "name": "Order Support", "status": "active" },
      "current_step": { "identifier": "wait_response", "stepable_type": "FlowWaitStep" }
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total_pages": 1, "total_count": 1 }
}

​

Workflows

https://api.example.com/mcp/{{system.customer.external_customer_id}}
Authorization: Bearer ${ENV:MCP_API_KEY}

​

Workflows

{{system.customer.id}}                    # Customer UUID
{{system.customer.external_customer_id}}  # Your external ID
{{system.customer.name}}                  # Customer name

​

Webhooks

• content - LLM-ready text representation of any message type (includes caption, file info, and transcript for audio)
• transcript - Speech-to-text transcription for audio messages with shape { text: "..." }

​

API changes

{
  "id": "uuid",
  "status": "running|waiting|completed|failed|stopped|handoff",
  "tracking_id": "custom-tracking-id",
  "whatsapp_conversation_id": "uuid",
  "started_at": "2025-11-27T10:00:00Z",
  "last_event_at": "2025-11-27T10:05:00Z",
  "ended_at": null,
  "workflow": {
    "id": "uuid",
    "name": "My Workflow"
  },
  "current_step": {
    "id": "uuid",
    "stepable_type": "FlowAgentStep"
  }
}

​

Workflows

• Duplicate flows - Clone existing flows via the canvas UI
• Wait step save_response_to - Save user response to a custom variable
• Failure email notifications - Automatic alerts when flow executions fail

• Handle non-JSON webhook bodies in flow webhooks
• Fix edge case where AI returns strings with backslash characters

​

Functions

​

Billing & projects

• Multiple projects - Create up to 6 projects
• Free digital phone number - Free plan now includes a digital phone number

​

UI/UX

• Mobile inbox - Improved mobile experience
• Triggers UI - Improved design for workflow triggers