AI 에이전트가 eSIMPal API를 통해 국제 eSIM 데이터 플랜을 검색, 구매 및 인도할 수 있도록 지원하는 포괄적인 통합 기능입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install esimpal-api
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 esimpal-api 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
eSIMPal API 에이전트 통합란 무엇인가요?
eSIMPal API 에이전트 스킬은 글로벌 연결 기능이 필요한 자동화 어시스턴트, 텔레그램 봇 또는 WhatsApp 통합을 구축하는 개발자를 위해 설계된 전문 도구입니다. Openclaw Skills 생태계의 일부로서, 이 도구는 에이전트가 eSIMPal 백엔드와 상호 작용하여 국가별 데이터 플랜 나열부터 보안 결제 처리 및 활성화 QR 코드 인도에 이르기까지 전체 고객 여정을 관리할 수 있도록 합니다.
보안은 이 스킬의 핵심입니다. 자율적 또는 숨겨진 구매를 방지하는 엄격한 런타임 규칙을 적용하여 모든 과금 작업이 사용자의 명시적인 확인을 거치도록 보장합니다. Openclaw Skills 설정 내에서 이를 활용함으로써 사용자가 제어권이나 재정적 안전을 희생하지 않고 여행 중에도 원활하고 대화식으로 연결 상태를 유지할 수 있는 방법을 제공할 수 있습니다.
eSIMPal API 에이전트 통합 활용 사례
- 사용자의 목적지에 따라 데이터 플랜을 제안하고 구매하는 여행 어시스턴트 제작.
- 메시징 플랫폼의 고객 지원 봇을 위한 eSIM 인도 자동화.
- 사용자가 기존 eSIM 프로필을 관리하고 재활성화할 수 있는 대시보드 구축.
- 데이터 패키지를 구매하는 해외 여행객을 위한 실시간 환율 변환 제공.
eSIMPal API 에이전트 통합 작동 원리
- 에이전트가 사용자의 대상 국가 및 데이터 요구 사항을 기반으로 사용 가능한 플랜을 API에 쿼리합니다.
- 플랜이 선택되면 에이전트는 중복 거래를 방지하기 위해 고유한 멱등성 키를 사용하여 주문을 생성합니다.
- 사용자가 다른 통화를 선호하는 경우 에이전트는 실시간 환율을 사용하여 주문 가격을 업데이트할 수 있습니다.
- 사용자가 명시적으로 동의하면 에이전트는 안전한 결제 처리를 위해 체크아웃 URL을 생성합니다.
- 에이전트는 eSIM이 프로비저닝될 때까지 지능형 폴링을 통해 주문 상태를 모니터링합니다.
- 마지막으로 에이전트는 QR 코드 또는 iOS 및 Android용 원클릭 설치 링크와 같은 활성화 세부 정보를 사용자에게 직접 전달합니다.
eSIMPal API 에이전트 통합 설정 가이드
이를 환경에 통합하려면 먼저 eSIMPal 개발자 대시보드에서 API 키를 얻어야 합니다. Openclaw Skills가 요청을 인증할 수 있도록 키를 환경 변수로 구성하세요.
export ESIMPAL_API_KEY="your_api_key_here"
API 키에 orders:read 및 orders:write에 필요한 범위가 있는지 확인하세요. 모든 요청은 기본 API URL인 https://getesimpal.com/api를 통해 라우팅됩니다.
eSIMPal API 에이전트 통합 데이터 스키마 및 분류 체계
이 스킬은 주문 및 eSIM 패키지를 나타내는 구조화된 JSON 객체를 통해 데이터를 관리합니다. 주요 데이터 요소는 다음과 같습니다.
| 객체 | 필드 | 설명 |
|---|---|---|
| Order | order_id |
트랜잭션의 고유 UUID. |
| Order | status |
현재 상태: created, ready, failed 또는 cancelled. |
| Package | package_id |
주문 내 특정 eSIM의 고유 식별자. |
| Activation | ios_activation_url |
Apple 기기용 원클릭 설치 딥 링크. |
| Activation | qr_code_url |
활성화 QR 코드의 PNG 이미지를 검색하는 URL. |
| Profile | esim_profile_id |
사용자의 특정 기기 프로필 식별자. |
eSIMPal API 에이전트 통합 고급 기능
- 네트워크 재시도가 중복 과금으로 이어지지 않도록 UUID를 사용한 강력한 멱등성 지원.
- 지수 백오프 및 Retry-After 헤더를 준수하는 지능형 폴링 전략.
- 신규 eSIM 활성화 및 기존 기기 프로필에 데이터 패키지 추가 지원.
- Android 및 iOS 원클릭 설정을 위한 특수 URL을 포함한 플랫폼 인식 인도 옵션.
- 결제 전 현지화된 가격 책정을 위해 PATCH 요청을 통한 기본 제공 통화 변환.
- Openclaw Skills 내에 민감한 데이터가 캐싱되는 것을 방지하기 위해 온디맨드로 이미지를 검색하는 안전한 QR 코드 처리.
SKILL.md
로드 중
관련 Openclaw 스킬
ClawClash
ClawClash는 AI 에이전트가 가상 통화를 사용하여 NBA 및 축구 시장에서 경쟁할 수 있도록 구축된 판타지 스포츠 예측 플랫폼입니다.
아마존 상품 스크래퍼
내장 브라우저를 사용하여 아마존 리스팅을 스크래핑하고 포괄적인 경쟁사 분석 보고서를 생성하는 자동화된 데이터 추출 도구입니다.
Telegram 스마트 런처
간소화된 상호작용을 위해 Telegram 응답에 동적 문맥 인식 CTA 버튼을 추가하는 정교한 UI 개선 사항입니다.
ClawNet
ClawNet은 OpenClaw 에이전트가 인터넷을 통해 안전하게 서로를 찾고 상호 작용할 수 있도록 P2P 발견 및 통신 프로토콜을 제공합니다.
AgentMemory
AI 에이전트가 여러 세션에 걸쳐 사실을 저장하고, 경험을 통해 배우며, 엔티티를 추적할 수 있게 해주는 지속적인 메모리 시스템입니다.
Last.fm 프로필 스킬
Last.fm 청취 데이터를 AI 워크플로우에 통합하여 현재 재생 중인 트랙, 인기 차트 및 사용자 프로필을 모니터링합니다.
OpenSubtitles
컨텍스트 인식 쇼 분석을 위해 타임스탬프별로 장면 컨텍스트를 추출하기 위해 자막을 검색하고 다운로드하는 읽기 전용 기능입니다.
추천*
