POST /open-api/v1/forms/{formId}/delivery

curl -X POST "https://api.walla.my/open-api/v1/forms/form_abc/delivery" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": [
      {
        "customerKey": "customer_001",
        "email": "john@example.com",
        "phoneNumber": "+821012345678"
      },
      {
        "customerKey": "customer_002",
        "email": "jane@example.com"
      }
    ],
    "subject": "We value your feedback!",
    "message": "Please take a moment to complete our survey."
  }'

{
  "success": true,
  "data": {
    "totalRecipients": 2,
    "successfulDeliveries": 2,
    "failedDeliveries": []
  }
}

{
  "success": true,
  "data": {
    "totalRecipients": 3,
    "successfulDeliveries": 2,
    "failedDeliveries": [
      {
        "customerKey": "customer_003",
        "email": "invalid-email",
        "phoneNumber": null,
        "error": "Invalid email format"
      }
    ]
  }
}

GET /open-api/v1/forms/{formId}/delivery

curl -X GET "https://api.walla.my/open-api/v1/forms/form_abc/delivery" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": [
    {
      "id": "delivery_123",
      "formId": "form_abc",
      "customerKey": "customer_001",
      "email": "john@example.com",
      "phone": "+821012345678",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T11:45:00Z"
    },
    {
      "id": "delivery_456",
      "formId": "form_abc",
      "customerKey": "customer_002",
      "email": "jane@example.com",
      "phone": null,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ]
}

POST /open-api/v1/forms/{formId}/delivery/status

curl -X POST "https://api.walla.my/open-api/v1/forms/form_abc/delivery/status" \
  -H "X-WALLA-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerKeys": ["customer_001", "customer_002", "customer_003"]
  }'

{
  "success": true,
  "data": [
    {
      "id": "delivery_123",
      "formId": "form_abc",
      "customerKey": "customer_001",
      "email": "john@example.com",
      "phone": "+821012345678",
      "status": "RESPONDED",
      "lastSentAt": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T14:20:00Z"
    },
    {
      "id": "delivery_456",
      "formId": "form_abc",
      "customerKey": "customer_002",
      "email": "jane@example.com",
      "phone": null,
      "status": "OPENED",
      "lastSentAt": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T11:15:00Z"
    },
    {
      "id": "delivery_789",
      "formId": "form_abc",
      "customerKey": "customer_003",
      "email": "bob@example.com",
      "phone": null,
      "status": "SENT",
      "lastSentAt": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ]
}

interface Recipient {
  customerKey: string;
  email?: string;
  phoneNumber?: string;
}

interface DeliveryOptions {
  subject?: string;
  message?: string;
}

async function sendForm(
  formId: string,
  recipients: Recipient[],
  options?: DeliveryOptions
) {
  const response = await fetch(
    `https://api.walla.my/open-api/v1/forms/${formId}/delivery`,
    {
      method: 'POST',
      headers: {
        'X-WALLA-API-KEY': process.env.WALLA_API_KEY!,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        recipients,
        subject: options?.subject || '설문이 도착했습니다.',
        message: options?.message || '설문 링크를 확인하세요.'
      })
    }
  );

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  return await response.json();
}

async function getDeliveryStatus(formId: string, customerKeys: string[]) {
  const response = await fetch(
    `https://api.walla.my/open-api/v1/forms/${formId}/delivery/status`,
    {
      method: 'POST',
      headers: {
        'X-WALLA-API-KEY': process.env.WALLA_API_KEY!,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ customerKeys })
    }
  );

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const data = await response.json();
  return data.data;
}

// Usage example
const result = await sendForm('form_abc', [
  {
    customerKey: 'customer_001',
    email: 'john@example.com'
  },
  {
    customerKey: 'customer_002',
    email: 'jane@example.com',
    phoneNumber: '+821012345678'
  }
], {
  subject: 'We need your feedback!',
  message: 'Please help us improve our services.'
});

console.log(`Successfully sent to ${result.data.successfulDeliveries} recipients`);

// Check status
const statuses = await getDeliveryStatus('form_abc', ['customer_001', 'customer_002']);
statuses.forEach(status => {
  console.log(`${status.customerKey}: ${status.status}`);
});

import requests
import os
from typing import List, Dict, Any, Optional

class WallaDeliveryAPI:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.walla.my/open-api/v1"
        self.headers = {
            "X-WALLA-API-KEY": api_key,
            "Content-Type": "application/json"
        }

    def send_form(
        self,
        form_id: str,
        recipients: List[Dict[str, str]],
        subject: Optional[str] = None,
        message: Optional[str] = None
    ) -> Dict[str, Any]:
        """Send form to recipients"""
        url = f"{self.base_url}/forms/{form_id}/delivery"
        payload = {
            "recipients": recipients,
            "subject": subject or "설문이 도착했습니다.",
            "message": message or "설문 링크를 확인하세요."
        }

        response = requests.post(url, headers=self.headers, json=payload)
        response.raise_for_status()
        return response.json()

    def get_all_deliveries(self, form_id: str) -> List[Dict[str, Any]]:
        """Get all delivery recipients for a form"""
        url = f"{self.base_url}/forms/{form_id}/delivery"
        response = requests.get(url, headers=self.headers)
        response.raise_for_status()
        return response.json()["data"]

    def get_delivery_status(
        self,
        form_id: str,
        customer_keys: List[str]
    ) -> List[Dict[str, Any]]:
        """Get delivery status for specific recipients"""
        url = f"{self.base_url}/forms/{form_id}/delivery/status"
        payload = {"customerKeys": customer_keys}

        response = requests.post(url, headers=self.headers, json=payload)
        response.raise_for_status()
        return response.json()["data"]

    def get_response_rate(self, form_id: str) -> float:
        """Calculate response rate for a form"""
        deliveries = self.get_all_deliveries(form_id)
        if not deliveries:
            return 0.0

        customer_keys = [d["customerKey"] for d in deliveries]
        statuses = self.get_delivery_status(form_id, customer_keys)

        responded = sum(1 for s in statuses if s["status"] == "RESPONDED")
        return (responded / len(statuses)) * 100

# Usage
api = WallaDeliveryAPI(os.getenv("WALLA_API_KEY"))

# Send form
result = api.send_form(
    "form_abc",
    [
        {"customerKey": "customer_001", "email": "john@example.com"},
        {"customerKey": "customer_002", "email": "jane@example.com"}
    ],
    subject="Your feedback matters!",
    message="Please take 2 minutes to complete our survey."
)

print(f"Sent to {result['data']['successfulDeliveries']} recipients")

# Check response rate
response_rate = api.get_response_rate("form_abc")
print(f"Response rate: {response_rate:.2f}%")

// 캠페인에 따른 맞춤화
const campaigns = {
  feedback: {
    subject: 'We value your feedback!',
    message: 'Help us improve our services by completing this quick survey.'
  },
  nps: {
    subject: 'How likely are you to recommend us?',
    message: 'Your opinion matters. Please share your thoughts.'
  }
};

await sendForm(formId, recipients, campaigns.feedback);