이 글은 이렇게 읽으세요

1. 먼저 기초 개념을 이해합니다. 이때 ChatGPT(앱)와 OpenAI API의 차이를 이해합니다.
2. 다음으로 통합 경로를 선택합니다. 코딩이 낯설면 플러그인 방식으로 시작하고, 보안이나 제어가 중요하면 커스텀 방식을 선택합니다. 반복 작업을 줄이고 싶다면 무코드 자동화를 고려합니다.
3. 배포 전에 임시 페이지에서 구성을 테스트합니다. 테스트가 끝나면 운영 환경에 배치합니다.

기초 개념 3분 요약

• ChatGPT(앱)는 사용자가 웹이나 앱에서 직접 대화하는 서비스입니다. 반면 OpenAI API는 우리 사이트가 서버에서 모델과 통신하기 위한 인터페이스입니다.
• 생성형 AI는 학습 데이터의 패턴을 바탕으로 새로운 텍스트나 이미지를 생성합니다. 대표 기술은 Transformer 기반의 대규모 언어 모델입니다.
• 핵심 파라미터는 모델, temperature, max_tokens입니다. 모델은 성능과 비용을 결정하고, temperature는 창의성을 조절하며, max_tokens는 응답 길이를 제한합니다.
• 쇼트코드는 워드프레스에서 대괄호 형태의 태그로 기능을 삽입하는 표준 방식입니다.
• REST 엔드포인트는 브라우저에서 워드프레스로, 그리고 워드프레스에서 OpenAI로 안전하게 요청을 중계하는 통로입니다.

시작 전 체크(필수)

• OpenAI API 키를 준비하고 결제 및 사용 한도를 설정합니다.
• 워드프레스 관리자 권한을 확인합니다.
• 테스트용 임시 페이지를 준비합니다.

🔑 OpenAI API Key 설정(완전 초보 가이드)

4.1 방법 1: OpenAI 콘솔에서 API 키를 발급합니다.

1. OpenAI Platform에 로그인한 뒤 상단의 Project를 선택하거나 새 프로젝트를 생성합니다.
2. Settings의 API keys 메뉴에서 새 비밀 키를 생성하고 표시되는 키를 복사하여 안전한 위치에 저장합니다.

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"gpt-4o-mini",
    "messages":[{"role":"user","content":"테스트"}],
    "max_tokens":30
  }'

4.2 방법 2: 키를 안전하게 보관하고 주기적으로 교체합니다.

• 키는 wp-config.php 또는 서버 환경 변수에만 저장합니다.
• 프로젝트별로 최소 권한을 부여하고 사용하지 않는 키는 비활성화합니다.
• 키는 정기적으로 교체하고 사용 내역을 점검합니다.
• 로그 접근 권한은 최소화하여 유출 위험을 줄입니다.

4.3 방법 3: 워드프레스에 키를 저장합니다(플러그인 또는 커스텀).

• 플러그인을 사용하는 경우 플러그인 설정 화면의 API Keys 메뉴에 키를 입력하고 저장합니다.
• 커스텀 방식을 사용하는 경우 wp-config.php에 상수로 키를 저장하고 서버에서만 읽어 사용합니다.

/* DB 설정 라인 아래에 추가합니다. */
define('OPENAI_API_KEY','여기에_본인_API_키');

통합 경로 선택: 플러그인과 커스텀 그리고 자동화를 비교합니다.

플러그인으로 시작하기

6.1 플러그인 추천과 선택 기준을 설명합니다.

• AI Engine은 챗봇과 AI 폼과 콘텐츠 도구와 내부 API 및 쇼트코드를 제공합니다.
• AI Power는 콘텐츠와 이미지와 음성과 자동화까지 모두 제공하며 여러 모델을 선택할 수 있습니다.
• WPBot은 상담과 FAQ 중심 기능을 제공하고 메신저와 WhatsApp 애드온을 지원합니다.
• AiBud WP는 템플릿 기반의 콘텐츠와 이미지 생성과 챗봇 기능을 제공합니다.
• WPForms + OpenAI는 Uncanny Automator나 Zapier와 연결하여 폼 제출을 자동화합니다.

6.2 빠른 선택 가이드의 요약 표를 확인합니다.

6.3 플러그인 상세 가이드를 제공합니다.

6.3.1 AI Engine(Meow Apps) 사용 방법을 소개합니다.

• 플러그인을 설치하고 활성화합니다.
• Meow Apps → AI Engine → Settings → API Keys에서 OpenAI 키를 저장합니다.
• Chatbots 탭에서 챗봇을 생성하고 단축코드를 복사하여 페이지에 삽입합니다.

[mwai_chatbot theme="bubble" window="embedded" max_messages="6" bot_name="도움이"]

6.3.2 AI Power(GPT AI Power) 사용 방법을 소개합니다.

• 플러그인을 설치한 뒤 AI Power → Dashboard에서 API 키를 입력합니다.
• Chat, Content Writer, Image, Agents 등 필요한 모듈만 활성화합니다.
• 제공되는 블록이나 단축코드 또는 위젯으로 페이지에 배치합니다.

6.3.3 WPBot 또는 ChatBot for WordPress(Social Intents) 사용 방법을 소개합니다.

• WPBot: WPBot → Settings에서 키·언어·UI를 설정하고, 필요하면 OpenAI·메신저 애드온으로 확장합니다.
• Social Intents: 외부 대시보드에서 봇을 만들고 WP 플러그인으로 연결해 전 페이지 팝업 또는 버튼으로 노출합니다.

6.3.4 AiBud WP 사용 방법을 소개합니다.

• AiBud WP → Settings → API Keys에서 키를 저장합니다.
• Content Builder, Playground, ChatBot 중 필요한 모듈을 선택해 사용합니다.

6.3.5 WPForms + OpenAI 사용 방법을 소개합니다.

• WPForms로 폼을 만들고 Uncanny Automator나 Zapier에서 제출을 트리거로 연결합니다.
• OpenAI 응답을 확인 메시지나 이메일 또는 CRM에 활용합니다.

커스텀: “내 API 게이트웨이”를 만들어 보안을 강화합니다.

브라우저는 워드프레스의 REST 엔드포인트만 호출하고, 워드프레스는 서버에서 OpenAI API를 호출합니다. 이렇게 하면 키가 브라우저에 노출되지 않습니다.

7.1 wp-config.php에 키를 저장합니다.

define('OPENAI_API_KEY','여기에_자신의_API_키');

7.2 REST 엔드포인트를 만듭니다.

add_action('rest_api_init', function(){
  register_rest_route('ai/v1','/chat',[
    'methods'=>'POST',
    'callback'=>'my_ai_chat_handler',
    'permission_callback'=>'__return_true' // 운영 시 권한 강화를 권장합니다.
  ]);
});

function my_ai_chat_handler( WP_REST_Request $req ){
  $msg = wp_strip_all_tags( $req->get_param('message') );
  if(!$msg) return new WP_Error('bad_request','message 필요',['status'=>400]);

  $payload = [
    "model"=>"gpt-4o-mini",
    "messages"=>[
      ["role"=>"system","content"=>"You are a helpful WordPress assistant who answers in Korean."],
      ["role"=>"user","content"=>$msg]
    ],
    "max_tokens"=>500,"temperature"=>0.6
  ];

  $res = wp_remote_post('https://api.openai.com/v1/chat/completions',[
    'headers'=>[
      'Authorization'=>'Bearer '.OPENAI_API_KEY,
      'Content-Type'=>'application/json; charset=utf-8'
    ],
    'timeout'=>45,
    'body'=>wp_json_encode($payload)
  ]);
  if(is_wp_error($res)) return new WP_Error('api_error',$res->get_error_message(),['status'=>500]);

  $code = wp_remote_retrieve_response_code($res);
  $body = json_decode( wp_remote_retrieve_body($res), true );
  if($code<200||$code>=300) return new WP_Error('api_error','OpenAI 오류',['status'=>$code,'detail'=>$body]);

  return ['reply'=>$body['choices'][0]['message']['content'] ?? '(응답 없음)'];
}

7.3 쇼트코드와 프런트 UI를 구성합니다.

add_shortcode('my_chatgpt', function(){
  ob_start(); ?>

  
💬 ChatGPT 상담원
  

  

    
    전송