Docs & Onboarding

고객이 바로 붙일 수 있도록 API, env, 시작 순서를 정리한다.

Quick start

1) 로그인 → 2) 프로젝트 생성 → 3) 연락처 등록 → 4) 메시지 발송

• Admin 로그인 후 Projects에서 워크스페이스를 만든다.

• Contacts에서 wallet recipient를 등록한다.

• Messages에서 대상 지갑에 outbound log를 남긴다.

• Usage에서 현재 사용량과 plan capacity를 본다.

Required environment variables

live provider 전환을 위한 핵심 변수

DATABASE_URL=postgres://...

JWT_SECRET=...

XMTP_ENV=production

XMTP_PROVIDER_MODE=mock|live

XMTP_WALLET_KEY=...

XMTP_ENCRYPTION_KEY=...

SDK direction

향후 JS SDK로 감쌀 때의 최소 인터페이스

client.projects.create()

client.contacts.create()

client.messages.send()

client.usage.summary()

Live provider note

현재 상태와 다음 단계

• 기본 모드는 `XMTP_PROVIDER_MODE=mock`

• `live` 모드로 전환하면 credential preflight를 수행

• SDK wiring 전까지는 live-stub/failed-unconfigured 응답을 반환

Send message example

현재 admin token 기반 API 호출 예시

curl -X POST https://xmtp.tetedo.com/api/messages/send \
  -H "Authorization: Bearer <admin-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "<project-id>",
    "contactId": "<contact-id>",
    "body": "GM from XMTP SaaS"
  }'