/** * 알림톡 도구 공용 — message-api `/alimtalk` 호출과 응답 포장. * * 2026-09-18 알림톡 API 가 commerce-api `/v1/alimtalk` 에서 message-api(`https://message.bootapi.com/alimtalk`)로 * 옮겨졌다. 옛 주소는 410 ALIMTALK_API_MOVED 를 낸다. 경로에 `/v1` 이 없는 것 말고는 인증·파라미터·응답이 같다. * * 인증은 커머스 연동키 Basic Auth 다(CommerceApiClient 가 키를 들고 있고, host: 'message' 로 보낸다). * 결제용 키(core)로는 호출되지 않는다. */ import type { CommerceApiClient, CommerceApiResponse } from '../commerce/client.js'; export type Json = Record; export type ToolResult = { content: Array<{ type: 'text'; text: string; }>; isError?: boolean; }; export declare function textResult(payload: unknown, isError?: boolean): ToolResult; /** 키가 없을 때 알림톡 도구가 모두 같은 안내를 돌려준다 */ export declare const CREDENTIALS_SETUP: string[]; /** 카카오 채널 관리 콘솔 — 사용자가 직접 들어가 확인·수정해야 하는 것들이 여기 있다 */ /** * 카카오비즈니스 파트너센터. 채널의 검색용 아이디 · 관리자 · 채널 공개 · 고객센터 정보가 전부 여기 있다. * 옛 채널 관리자센터(center-pf.kakao.com)는 2026 현재 이 주소로 301 리다이렉트된다 — 옛 주소를 안내하지 마라. */ export declare const KAKAO_CHANNEL_CONSOLE = "https://business.kakao.com/dashboard"; /** * API 알림톡 충전 설정 화면. * 알림톡은 건당 과금이라 이걸 켜기 전에는 발송이 통째로 막힌다. 그런데 서버가 그 상태를 * 전용 코드가 아니라 500 SERVER_ERROR 로 내는 경우가 있어(실측 2026-09-16), 코드만 보면 * 일시 장애로 오해한다. 발송 실패에는 이 주소를 같이 준다. */ export declare const MESSAGE_BILLING_URL = "https://admin.bootpay.co.kr/notification/edit?cursor=subscribe"; /** * 연동할 카카오 채널이 없을 때의 안내. * * 이 단계는 AI 가 대신 해줄 수 없다 — 채널 개설·비즈니스 전환·고객센터 정보는 카카오 콘솔에서 * 사람이 하고, OTP 는 실제 문자로 나간다. 그래서 「무엇을 어디서 확인하고 무엇을 들고 오면 되는지」를 * 주소까지 적어 돌려준다. 이게 없으면 AI 가 "채널을 연동하세요" 만 반복하고 사용자는 어디로 * 가야 하는지 모른 채 막힌다. */ export declare const CHANNEL_SETUP: string[]; export declare function credentialsMissing(): ToolResult; /** * error_code → 다음에 할 일. * 문구는 commerce.bootpay.ai 알림톡 문서의 에러 코드표를 옮겼다. 상태 코드가 아니라 error_code 로 가른다 * (같은 404 가 키 오류일 수도, 채널 미연동일 수도 있다). */ export declare const ERROR_HINTS: Record; export declare function failure(res: CommerceApiResponse, extra?: Json): ToolResult; export declare function query(params: Json): string; export declare const enc: typeof encodeURIComponent; /** 발송내역 조회를 가장 넓게 열 때의 s_at */ export declare function historyStartAt(now?: number): string; /** 목록 응답에서 배열을 꺼낸다 — `{ list: [...] }` 와 `[...]` 둘 다 받는다 */ export declare function listOf(data: unknown): Json[]; export declare function isRecord(value: unknown): value is Json; export declare class AlimtalkApi { private readonly client; constructor(client: CommerceApiClient); hasCredentials(): boolean; /** 도구 응답에 얹을 환경 표시(+비운영 경고). 알림톡은 실제 발송·과금이라 환경을 숨기면 안 된다. */ envFields(): { environment: string; environment_warning?: string; }; get(path: string, params?: Json): Promise>; post(path: string, body?: Json): Promise>; put(path: string, body: Json): Promise>; del(path: string): Promise>; postForm(path: string, form: FormData): Promise>; } /** 도구 대부분의 모양 — 키 확인 → 호출 → 성공이면 data(+ 덧붙일 안내), 실패면 error_code 별 hint */ export declare function call(api: AlimtalkApi, request: () => Promise, extra?: (data: unknown) => Json): Promise; //# sourceMappingURL=api.d.ts.map