콘텐츠로 이동
Quickchat AI Documentation
EnglishDeutschEspañolFrançais日本語PolskiPortuguêsSvenskaالعربيةBahasa IndonesiaРусскийTiếng Việt繁體中文ไทยItalianoNederlandsУкраїнськаעברית한국어Türkçe

WhatsApp

Quickchat AI 에이전트를 WhatsApp Business에 연결하세요. 이 안내에서는 사전 요구 사항, 설정 단계, WhatsApp 메시지 응대 시작 방법을 설명합니다.

이 안내에서는 Quickchat AI 에이전트를 WhatsApp에 연동하는 방법을 설명합니다. 과정은 간단한 두 단계로 나뉩니다.

  • 0단계: 사전 요구 사항
  • 1단계: WhatsApp 연결

연동 중 문제가 있거나 도움이 필요하면 문제 해결 및 자주 묻는 질문을 확인하거나 문의해 주세요.

선택적으로 사용할 수 있는 설정 도구

섹션 제목: “선택적으로 사용할 수 있는 설정 도구”

  • WhatsApp 설정 요구 사항 확인하기. 입력한 번호와 제공업체 정보를 문서화된 설정 요구 사항과 비교합니다. WhatsApp 계정에 접근하거나 계정을 연결하지는 않습니다.

  • WhatsApp 고객 응대 시간 확인하기. 시간대 오프셋을 포함하여 입력한 수신 시각과 답변 시각으로 24시간 응대 가능 시간을 확인합니다. 템플릿, 동의, 계정 권한을 검증하거나 메시지를 보내지는 않습니다.

  • 사용 비용 추산하기. Quickchat AI 모델 크레딧과 입력한 요금 항목의 합계를 별도로 계산합니다. 제공업체의 요금을 조회하거나 크레딧과 금액을 합산하거나 계정을 확인하지는 않습니다.

동영상 보기

섹션 제목: “동영상 보기”
Play

0단계: 사전 요구 사항

섹션 제목: “0단계: 사전 요구 사항”

A. 비즈니스 전화번호

섹션 제목: “A. 비즈니스 전화번호”

WhatsApp에 사용할 전화번호를 정하세요. WhatsApp 문서에서 자세한 내용을 읽거나 아래 자주 묻는 질문을 참고하세요.

WhatsApp Cloud API에는 어떤 번호를 사용할 수 있나요?

  • 인증을 위한 SMS 또는 음성 통화를 받을 수 있는 비즈니스 전용 전화번호가 필요합니다.
  • 번호는 유효하고 본인 소유여야 하며 국가 번호와 지역 번호를 포함해야 합니다.

WhatsApp Messenger에서 이미 사용하는 번호를 쓸 수 있나요?

  • 아니요. 일반 전화와 문자에는 계속 사용할 수 있지만 WhatsApp Messenger에서는 사용할 수 없습니다.
  • 이미 WhatsApp Messenger에서 사용하는 번호라면 먼저 해당 등록을 삭제하세요. WhatsApp 채팅 기록 백업도 잊지 마세요.
  • 차단된 번호는 등록 전에 차단을 해제해야 합니다.

WhatsApp Business App에서 이미 사용하는 번호를 쓸 수 있나요?

  • Quickchat AI의 현재 연결 과정은 기존 WhatsApp Business App 번호에 대해 검증된 Coexistence 연결 방식을 제공하지 않습니다. Meta는 Business App 온보딩 안내에서 지원되는 연동의 동시 사용 방식을 설명합니다.
  • 기존 번호, Business App 계정, 채팅 기록을 유지해야 한다면 진행 전에 support@quickchat.ai로 이메일을 보내세요. 문제를 해결하려고 Business App 계정을 삭제하거나 연결을 해제하거나 번호를 이전하지 마세요.

새 전화번호를 사용해도 되나요?

  • 네. 현재 번호를 사용하고 싶지 않다면 새 번호를 준비하세요. 실물 SIM이나 가상 번호를 사용할 수 있습니다. Hushed 같은 서비스에서 가상 전화번호를 구매할 수 있습니다.

B. 비즈니스 정보

섹션 제목: “B. 비즈니스 정보”

다음 정보를 준비하세요. Meta 연동 과정에서 입력하게 됩니다.

  • 비즈니스 이름
  • 비즈니스 웹사이트
  • 비즈니스 카테고리
  • 비즈니스 설명

일부 항목이 선택 사항으로 보여도 정확하게 입력하세요. 정보가 빠지거나 부정확하면 승인이 지연되거나 계정이 제한될 수 있습니다.

1단계: WhatsApp 연결

섹션 제목: “1단계: WhatsApp 연결”

Quickchat AI 앱 → External Apps → WhatsApp으로 이동해 Connect WhatsApp을 클릭하고 Meta 팝업의 안내를 따르세요.

ChatGPT, Claude 또는 연결된 다른 AI 앱에서도 시작할 수 있습니다. 이 에이전트를 WhatsApp에 연결할 링크를 요청하세요. 링크는 10분 동안 유효하며 요청한 Quickchat 계정에서 한 번만 사용할 수 있습니다. 해당 계정으로 로그인한 브라우저에서 열고 Meta 설정을 따른 뒤 Quickchat이 다시 열리면 필요한 계정 또는 전화번호 선택을 마치세요. 이후 AI 앱에 설정을 확인해 달라고 요청하고 실제 WhatsApp 메시지를 보내 AI 답변이 도착하는지 확인하세요. 번호를 여러 개 연결했다면 활성화된 번호마다 테스트하세요. Meta 접근 권한은 브라우저에서 승인하며 채팅에서 토큰을 공유하지 않습니다.

  1. Meta(Facebook) 계정에 로그인하세요.
  2. Quickchat AI에 제공할 권한인 WhatsApp Business 계정 접근 및 비즈니스 포트폴리오 접근 권한을 검토하고 계속하세요.
  3. 비즈니스 포트폴리오, 비즈니스 이름, 웹사이트, 국가 등 정확한 비즈니스 정보를 입력하세요.
  4. WhatsApp Business 계정을 만들거나 선택하세요.
  5. WhatsApp Business 표시 이름과 카테고리를 정하세요.
  6. 비즈니스 전화번호를 추가하고 안내에 따라 SMS나 음성 통화로 인증하세요.
  7. Confirm을 클릭해 Quickchat AI에 필요한 접근 권한을 부여하세요.
  8. Meta가 설정 완료를 확인하면 Finish를 클릭하세요. 팝업에 WhatsApp 계정이 연결되었다는 Quickchat AI 확인 메시지가 표시된 뒤 자동으로 닫힙니다.

Meta가 여러 계정에 대한 접근 권한을 제공하면 WhatsApp 패널은 즉시 연결하는 대신 Choose your WhatsApp Business Account를 표시합니다. AI 에이전트가 응대할 계정을 선택하고 Use this account를 클릭하세요. 다시 연결하는 경우 확인하기 전까지 기존 WhatsApp 설정은 바뀌지 않습니다.

Quickchat AI 앱으로 돌아오면 본인의 비즈니스 번호에서 성공적인 메시지 교환이 확인될 때까지 WhatsApp 패널에 Finish setup이 표시됩니다. 약 30초 후에도 패널이 갱신되지 않으면 새로고침 아이콘을 클릭하세요.

Meta 연결과 메시지 수신은 설정 과정의 일부일 뿐입니다. 패널은 활성화된 번호마다 다음 단계를 표시합니다.

  • Waiting for your first message: 다른 전화에서 표시된 번호로 WhatsApp 메시지를 보내고 Refresh를 클릭하세요. 고객이 사용할 비즈니스 번호로 보내야 합니다.
  • Waiting for the AI reply to be delivered: Quickchat은 메시지를 받았지만 WhatsApp이 아직 AI 답변의 전달을 확인하지 않았습니다. 다른 전화에 답변이 도착했는지 확인하세요. 도착하지 않았다면 AI 크레딧과 패널의 경고를 확인하고 테스트 메시지를 다시 보내세요.
  • AI reply delivered: WhatsApp이 이 비즈니스 번호로 받은 메시지에 대한 AI 답변이 전달되었음을 확인했습니다.
  • Verification needs attention: 연결 경고를 해결하고 사용할 번호를 활성화한 상태로 유지한 뒤 새 테스트 메시지를 보내세요.
  • Display name: 패널 아래쪽에 나열된 각 번호에는 Meta의 표시 이름 상태(Approved, Pending review, Declined, Expired, No display name)가 표시됩니다. 검토 중이라면 별도 조치가 필요 없으며 보통 며칠 안에 끝납니다. 이름이 거절되거나 만료되었거나 없으면 WhatsApp Manager에서 이름을 제출하라는 안내가 나옵니다.
  • Meta test number: Meta가 제공한 +1 555 번호와 샌드박스 번호로는 본인의 비즈니스 번호 활성화를 검증할 수 없습니다. WhatsApp Manager에 본인 번호를 추가하고 Quickchat에서 활성화한 뒤 해당 번호를 테스트하세요.

활성화된 모든 비즈니스 번호에서 메시지 교환이 검증되고 연결 상태 검사도 정상일 때 패널에 Live가 표시됩니다. 여러 비즈니스 번호를 켰다면 각각 테스트하세요. 테스트 번호와의 성공적인 교환, 템플릿 전송, 메시지 한도 안내만으로는 이 검증이 완료되지 않습니다.

테스트하는 동안 연동을 켜 두세요. 다른 전화에서 사용할 각 비즈니스 번호로 메시지를 보내고 AI 답변 도착을 확인한 뒤 Refresh를 클릭하세요. 대화는 Quickchat AI 앱의 Inbox에도 표시되어야 합니다. 기존 연결에도 전달을 확인하기 위한 새로운 테스트 교환이 요구될 수 있습니다. 이 단계를 마치는 동안에도 기존 연결은 계속 메시지를 받고 답할 수 있습니다.

Meta 온보딩 단계가 남아 있다면 Setup guidance를 열어 WhatsApp Manager에서 완료하세요. Meta 설정이 끝나지 않은 경우 Quickchat AI는 계정 소유자에게 알림 이메일도 보냅니다.

문제 해결 및 자주 묻는 질문

섹션 제목: “문제 해결 및 자주 묻는 질문”

WhatsApp Business API 요금은 어떻게 적용되나요?

  • WhatsApp은 사용자가 먼저 보낸 수신 문의에 대한 답변을 서비스 메시지로 취급합니다. 기업은 직원이나 대화형 AI 봇을 통해 이 메시지로 고객 문의를 처리할 수 있습니다.
  • 사용자가 기업에 메시지를 보내면 24시간 고객 응대 시간이 시작됩니다. 이 시간 동안 기업은 서비스 메시지로 무료로 답할 수 있습니다. 이 시간은 사용자 메시지마다 다시 시작됩니다.
  • 24시간이 지나면 승인된 메시지 템플릿(Marketing, Utility, Authentication 등)을 사용해야 하며 WhatsApp Business Platform 메시지 요금에 따라 메시지별로 비용이 부과됩니다.
  • 대화는 Meta가 분류하고 청구합니다. 기업이 먼저 보내는 메시지나 템플릿 메시지를 위해 WhatsApp Business 계정에 유효한 결제 수단을 등록하세요.

Connect WhatsApp 버튼이 작동하지 않고 Meta 팝업이 보이지 않습니다.

  • 브라우저가 팝업을 차단한다면 Quickchat AI 앱의 팝업을 허용한 뒤 Try again을 클릭하세요. Continue on Meta in this tab을 클릭하면 팝업 없이 같은 설정을 완료할 수도 있습니다.

Quickchat couldn’t confirm the WhatsApp connection

Meta 창에서 결과가 돌아오지 않고 Quickchat도 연결을 확인할 수 없을 때 이 복구 안내가 표시됩니다. Meta가 아무 변경도 하지 않았다는 뜻은 아닙니다.

  1. WhatsApp Business 계정을 소유한 Meta 비즈니스의 관리자인지 확인하세요. 관리자가 아니라면 관리자에게 본인의 Facebook 로그인으로 연결해 달라고 요청하세요.
  2. Try again을 클릭하세요. 차단 도구가 Meta 창을 방해하면 확장 프로그램을 일시 중지한 비공개 창을 사용하거나 Continue on Meta in this tab을 클릭하세요.
  3. 번호가 WhatsApp Messenger에서 사용 중이면 먼저 그곳에서 제거하거나 다른 번호를 사용하세요. WhatsApp Business App에서 사용 중이면 여기서 멈추고 진행 전에 support@quickchat.ai로 이메일을 보내세요. Quickchat AI의 현재 연결 과정은 검증된 Coexistence 방식을 제공하지 않습니다. 이 메시지를 해결하려고 Business App 계정을 삭제하거나 연결을 해제하거나 번호를 이전하지 마세요.
  4. WhatsApp Business 계정이 Aircall, Twilio, 360dialog, MessageBird 또는 다른 제공업체를 사용한다면 Meta Business Settings에서 Quickchat AI를 파트너로 추가하세요.
    1. Meta Business Settings를 열고 Accounts → WhatsApp Accounts로 이동하세요.
    2. WhatsApp Business 계정을 선택하고 Partners를 연 뒤 Add Partners를 클릭하세요.
    3. Quickchat AI의 Business ID 270696274483463을 입력하세요.
    4. Manage WhatsApp accounts 권한을 부여하고 Quickchat AI로 돌아와 상태를 새로고침하세요.

Meta가 해당 계정에 두 파트너를 허용하지 않을 때만 다른 제공업체의 연결을 해제하세요. 확실하지 않으면 운영 중인 메시징 제공업체를 해제하기 전에 지원팀에 문의하세요.

번호 인증에 실패했습니다.

  • 번호가 SMS나 음성 통화를 받을 수 있는지 확인하세요.
  • 일반적인 Ineligible 메시지나 This number can’t be shared with this app 툴팁만으로는 원인이나 Meta의 동시 사용 요구 사항 충족 여부를 알 수 없습니다. 정확한 메시지와 표시된 단계를 support@quickchat.ai로 보내세요.
  • 번호가 WhatsApp Business App에서 사용 중이고 해당 계정과 기록을 유지해야 한다면 진행 전에 지원팀에 문의하세요. 오류를 없애려고 계정을 삭제하거나 연결을 해제하거나 번호를 이전하지 마세요.

잘못된 계정을 연결했습니다.

  • Reconnect는 이미 연결된 계정을 유지합니다. AI 에이전트를 다른 WhatsApp Business 계정으로 옮기려면 WhatsApp 패널에서 Disconnect를 클릭한 뒤 Connect WhatsApp을 다시 클릭하세요. Meta 창에서 올바른 Meta Business 계정과 WhatsApp 계정을 선택하세요.

We could not tell which WhatsApp Business Account to connect

  • Meta 로그인에 전화번호가 있는 WhatsApp Business 계정이 여러 개 있어 Quickchat이 어떤 계정을 원하는지 판단하지 못한 것입니다. 연결할 전화번호를 support@quickchat.ai로 보내 주시면 설정을 도와드리겠습니다.

메시지가 Quickchat AI Inbox에 나타나지 않습니다.

  • 팝업에 최종 확인 메시지 _“WhatsApp account connected!”_가 표시되었는지 확인하세요.
  • 의도한 WhatsApp 계정을 연결했고 올바른 AI 에이전트가 선택되어 있는지 다시 확인하세요.
  • Waiting for your first message 카드에는 AI 에이전트가 답하는 번호가 표시됩니다. 정확히 그 번호로 메시지를 보냈고 패널에서 해당 번호가 켜져 있는지 확인한 뒤 Refresh를 클릭하세요.
  • 사용자 메시지 없이 24시간이 지난 뒤 메시지를 보내려면 승인된 템플릿을 사용하고 WhatsApp Manager에 결제 수단이 설정되어 있는지 확인하세요.

AI의 WhatsApp 답변을 보낼 수 없습니다.

AI 답변이 전달되지 않으면 Quickchat AI는 External Apps의 WhatsApp 패널에 “WhatsApp replies are failing” 경고를 표시하고 대시보드에도 알림을 보냅니다. 일반적인 원인과 해결 방법은 다음과 같습니다.

  • Meta 테스트 번호의 표시 이름이 승인되지 않음: Meta는 제공한 +1 555 번호의 표시 이름이 승인될 때까지 답변을 보류합니다. 패널의 표시 이름 경고가 빨간색으로 바뀌고 해당 번호를 표시합니다. 검토가 끝날 때까지 기다리세요. 보통 며칠이 걸립니다. 거절되었다면 WhatsApp Manager에서 새 표시 이름을 제출한 뒤 테스트 메시지를 보내세요. 본인 번호의 표시 이름이 검토 중인 것만으로는 답변이 차단되지 않으며 패널에는 참고 안내로 표시됩니다.
  • 연결 만료 또는 취소: WhatsApp 연결이 더 이상 유효하지 않습니다. WhatsApp 패널을 열고 Reconnect를 클릭하여 답변 전송을 재개하세요.
  • 번호 제한: Meta가 품질 등급이나 정책 문제로 번호를 제한했습니다. WhatsApp Manager에서 상태를 확인해 전송 기능을 복구하세요.
  • Business 계정 잠김(오류 131031): Meta가 WhatsApp Business 계정의 답변을 차단했습니다. Inbox의 전달 오류와 WhatsApp 패널에서 제한 내용을 확인할 수 있습니다. Business Support Home을 열고 WhatsApp 계정과 위반 항목을 선택한 뒤 Request Review를 클릭하세요. Meta는 이 검토 절차를 통해서만 계정 잠금을 해제합니다. Quickchat을 다시 연결해도 제한은 해제되지 않습니다.

그 밖의 경고는 답변이 다시 성공적으로 전송되면 자동으로 사라집니다. 계정 잠금 경고는 실제 방문자의 새 메시지에 대한 AI 답변이 완전히 전달될 때까지 유지됩니다. Meta가 답변을 접수한 뒤에도 전달에 실패할 수 있기 때문입니다. 활성화된 번호가 Meta 테스트 번호(+1 555)뿐이면 다음 AI 답변이 성공적으로 전송될 때 경고가 사라집니다. Support AI도 최근 저장된 계정 잠금 오류를 설명할 수 있지만 과거 기록만으로 현재도 계정이 잠겨 있다고 확정할 수는 없습니다.

템플릿 메시지나 기업이 먼저 보내는 메시지가 실패합니다.

  • WhatsApp Manager에서 메시지 템플릿이 승인되어 있고 결제 수단이 활성화되어 있는지 확인하세요.
  • 신규 발신자에게는 품질과 인증 상태에 따라 확대되는 메시지 한도가 적용됩니다. 기업이 먼저 보내는 메시지의 한도에 도달하면 Meta의 Messaging Limits 안내를 참고하세요.
  • 전달이 제한된다면 WhatsApp Manager에서 메시지 한도와 품질 등급을 확인하세요.

전용 WhatsApp 링크와 “Chat on WhatsApp” 버튼은 어떻게 만드나요?

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

또는

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

전용 WhatsApp QR 코드는 어떻게 만드나요?

  • WhatsApp Manager → Phone numbers → 비즈니스 전화번호 선택 → Message links → Create Message Link로 이동하세요.
  • WhatsApp Business 모바일 앱에서도 찾을 수 있습니다. 이 WhatsApp 안내를 따르세요.

설정 문제를 해결하려면 WhatsApp Business App 계정 연결을 해제해야 하나요?

  • 아니요. 문제 해결을 위해 Business App 계정을 삭제하거나 연결을 해제하거나 번호를 이전하지 마세요. Quickchat AI의 현재 연결 과정은 기존 앱 설정과 기록을 보존하는 검증된 Coexistence 방식을 제공하지 않습니다.
  • 운영 중인 Business App 계정을 바꾸기 전에 support@quickchat.ai로 이메일을 보내세요. Meta의 Business App 온보딩 안내는 지원되는 연동의 동시 사용 방식을 설명할 뿐, 현재 Quickchat AI 설정에서 사용할 수 있다는 확인은 아닙니다.

Quickchat AI는 WhatsApp Business 계정에 어떤 접근 권한을 받나요?

  • 범위가 제한된 API 접근 권한이며 계정 소유권은 아닙니다. WhatsApp Business 계정(WABA)은 본인의 Meta Business Manager에 유지됩니다. Meta의 WABA Sharing 모델에서는 자산을 직접 소유하고 Quickchat AI는 파트너로 추가됩니다. 언제든 Business Manager에서 파트너 접근을 취소할 수 있습니다.
  • 연동이 활성화된 동안 Cloud API로 메시지를 주고받고 웹훅으로 메시지 이벤트를 받을 수 있습니다.
  • 계정을 폐쇄하거나 이전하거나 브랜드를 변경하거나, 결제 정보를 바꾸거나, 관리자를 제거할 수는 없습니다.

도움이 필요하신가요?

섹션 제목: “도움이 필요하신가요?”

WhatsApp에서 Quickchat Support AI와 대화하세요.
📱 +1 302-405-9992: 채팅 시작하기

또는 QR 코드를 스캔하세요.

WhatsApp QR 코드

마지막 업데이트:

시작하기

소개빠른 시작AI로 관리하기

AI 에이전트

IdentityKnowledge Base

액션

ActionsEnglishHuman HandoffEnglishSmart Data GatheringEnglishMCP ActionsEnglishGoogle SheetsEnglishAI Action VariablesEnglishJira ticket searchEnglish
Images & filesEnglishDuplicate an AI AgentEnglish

대화

InboxEnglish
인사이트
테스트

채널

웹사이트

웹사이트WordPressEnglishShopifyEnglishDrupalEnglish

헬프데스크 및 CRM

IntercomEnglishHubSpotEnglishEmailEnglishZendeskEnglish

메신저 앱

DiscordWhatsAppTelegramSlackEnglishFacebook MessengerEnglishInstagramEnglish
MCPEnglish

계정 및 결제

Account access and password recoveryEnglishTeam & rolesEnglishPlans & limitsEnglishUnderstanding AI creditsEnglishQuickchat Support AIEnglishDelete an AI AgentEnglish
GitHubXDiscordYouTube