이 가이드는 Quickchat AI Agent를 WhatsApp과 통합하는 방법을 보여줍니다. 과정은 간단한 2단계로 나뉩니다.
- Step 0 - 사전 준비 사항
- Step 1 - WhatsApp 연결
통합에 문제가 있거나 도움이 필요하면 문제 해결 및 FAQ 섹션으로 이동하거나 문의해 주세요.
동영상 보기
Step 0 - 사전 준비 사항
A. 비즈니스 전화번호
WhatsApp에 사용할 전화번호를 정하세요. WhatsApp 문서에서 자세히 읽어보거나 아래 FAQ를 따르세요.
WhatsApp Cloud API에서 어떤 번호를 사용할 수 있나요?
- 인증을 위해 SMS 또는 음성 통화를 받을 수 있는 전용 비즈니스 전화번호를 사용해야 합니다.
- 번호는 유효해야 하며, 본인 소유이고 국가 번호와 지역 번호가 있어야 합니다.
이미 WhatsApp Messenger에서 사용 중인 번호를 사용할 수 있나요?
- 아니요. 이 번호를 통화와 문자에는 계속 사용할 수 있지만, WhatsApp Messenger에서는 사용할 수 없습니다.
- 번호가 이미 WhatsApp Messenger에서 사용 중이라면 먼저 삭제하세요. WhatsApp 채팅 기록을 백업하는 것을 잊지 마세요.
- 차단된 번호는 등록하기 전에 차단 해제되어야 합니다.
이미 WhatsApp Business App에서 사용 중인 번호를 사용할 수 있나요?
- 예. 현재 번호가 WhatsApp Business App에서 사용 중이라면, 앱 계정을 삭제하지 않고 Cloud API에 온보딩할 수 있을 수 있습니다. Meta 문서에서 Coexistence 온보딩에 대해 자세히 읽어보세요.
새 전화번호를 사용할 수 있나요?
- 예. 현재 번호를 사용하고 싶지 않다면 새 번호(물리 SIM 또는 가상 번호)를 받으세요. Hushed 같은 서비스에서 가상 전화번호를 구매할 수 있습니다.
B. 비즈니스 정보
다음 정보를 준비해 두세요. Meta 통합 흐름 중에 입력하게 됩니다.
- 비즈니스 이름
- 비즈니스 웹사이트
- 비즈니스 카테고리
- 비즈니스 설명
일부 필드가 선택 사항처럼 보이더라도 정확하게 입력하세요. 누락되거나 부정확한 정보는 승인 지연 또는 계정 제한을 초래할 수 있습니다.
Step 1 - WhatsApp 연결
최신 업데이트 이후 연결은 한 번의 클릭으로 완료됩니다. 더 이상 별도의 두 번째 단계가 없습니다. Meta의 자체 Embedded Signup 마법사가 새 WhatsApp Business Account와 번호를 만들거나 이미 보유한 항목을 선택하는 과정을 안내하며, 나머지는 Quickchat AI가 완료합니다.
Quickchat AI App을 열고 → External Apps → WhatsApp → Connect WhatsApp 버튼을 클릭한 다음 Meta 팝업을 따르세요.
- Meta(Facebook) 계정에 로그인합니다.
- Quickchat AI와 공유할 권한(WhatsApp Business 계정 액세스 및 Business portfolio 액세스)을 검토하고 계속 진행합니다.
- 정확한 비즈니스 세부 정보(Business Portfolio, Business Name, Business Website, Country 등)를 제공합니다.
- WhatsApp Business Account를 만들거나 선택합니다.
- WhatsApp Business 표시 이름과 카테고리를 선택합니다.
- 비즈니스 전화번호를 추가하고 안내에 따라 SMS/음성으로 인증합니다.
- Confirm을 클릭하여 Quickchat AI에 필요한 액세스 권한을 부여합니다.
- Meta가 설정 완료를 확인하면 Finish를 클릭합니다. 팝업에는 WhatsApp 계정이 연결되었다는 Quickchat AI 확인 메시지가 표시되고 자동으로 닫힙니다.
Quickchat AI App으로 돌아가면 WhatsApp 패널에 Connecting your WhatsApp account가 표시되고 약 30초 이내에 Connected로 업데이트됩니다. 업데이트되지 않으면 패널에서 Refresh Status를 클릭하세요. 그래도 안 되면 위의 사전 준비 사항을 다시 확인하여 비즈니스 전화번호와 정보를 올바르게 제공했는지 확인해 주세요.
Connected는 Quickchat AI가 WhatsApp Business Account에 연결할 수 있다는 뜻입니다. 그 바로 아래에 있는 패널에는 고객이 답변을 받기 전에 아직 필요한 항목이 표시됩니다.
Connected 패널에는 남은 항목이 표시됩니다. 여기서는 첫 메시지입니다
- Waiting for your first message: 다른 휴대폰에서 표시된 번호로 WhatsApp 메시지를 보낸 다음 Refresh를 클릭하세요. 메시지가 도착하면 패널에 Webhook Active 및 Admin Assigned 옆에 Messages Received가 표시됩니다.
- Display name: 패널 하단에 나열된 각 번호에는 Meta의 표시 이름 상태(Approved, Pending review, Declined, Expired 또는 No display name)가 표시됩니다. 검토가 진행 중이면 사용자가 할 일은 없으며 보통 며칠 내에 완료됩니다. 거절되었거나 만료되었거나 표시 이름이 없는 경우 WhatsApp Manager에서 제출해야 합니다.
- Meta test number: 활성 번호가 Meta에서 제공한 +1 555 번호인 경우 패널에 그렇게 표시됩니다. 이 번호는 테스트용이며 다른 계정으로 이동할 수 없습니다. 실제 운영으로 전환하려면 WhatsApp Manager에서 본인 번호를 추가하세요.
패널에 Messages Received가 표시되면 운영이 시작된 것입니다! 🎉 고객은 WhatsApp 번호로 메시지를 보낼 수 있으며, AI Agent가 자동으로 응답합니다.
통합을 최종 확인하려면 방금 연결한 WhatsApp 번호로 문자 메시지를 보낸 다음 패널에서 Refresh를 클릭하세요. Waiting for your first message가 Messages Received로 바뀌고, AI Agent로부터 답변을 받아야 하며, 대화가 Quickchat AI App Inbox에 표시되어야 합니다. Meta 설정 단계 중 완료하지 않은 항목이 있으면 Quickchat AI는 계정 소유자에게 남은 단계를 이메일로도 알립니다.
문제 해결 및 FAQ
WhatsApp Business API 가격은 어떻게 작동하나요?
- 사용자가 시작한(인바운드) 고객 문의에 대한 답변은 WhatsApp에서 Service messages로 처리합니다. 이러한 메시지를 통해 비즈니스는 사람 상담원 또는 대화형 AI 기반 봇을 통해 들어오는 고객 문의를 관리할 수 있습니다.
- 사용자가 비즈니스에 메시지를 보내면 24시간 고객 서비스 창이 열리며, 이 기간 동안 비즈니스는 무료로 서비스 메시지로 응답할 수 있습니다. 이 창은 사용자 메시지가 올 때마다 재설정됩니다.
- 24시간 이후에는 승인된 Message Templates(Marketing, Utility, Authentication 등)를 사용해야 하며, WhatsApp Business Platform Message Rates에 따라 메시지별로 비용을 지불해야 합니다.
- 대화는 Meta에서 분류하고 청구합니다. 비즈니스에서 시작하는 메시지 또는 템플릿 메시지를 위해 WhatsApp Business Account에 유효한 결제 수단이 있는지 확인하세요.
Connect WhatsApp 버튼이 작동하지 않습니다. Meta 팝업이 보이지 않습니다.
- 브라우저가 팝업을 차단하면 앱에 팝업 허용을 요청하는 메시지가 표시됩니다. 브라우저에서 팝업 및 트래커 차단기를 비활성화하고 웹사이트를 새로고침한 뒤 다시 시도하세요. 그래도 해결되지 않으면 다른 브라우저를 사용해 보세요.
번호 인증에 실패했습니다.
- 번호가 SMS/음성 통화를 받을 수 있고, Meta가 공존을 허용하지 않는 활성 등록 경로에 의해 차단되어 있지 않은지 확인하세요. 번호가 Business App에서 사용 중이라면 Coexistence를 통한 온보딩을 시도해 보세요.
Meta에서 설정이 완료되지 않았다고 하거나 패널에 경고가 표시됩니다.
- 먼저 Connected 아래의 카드를 읽으세요. 이 카드에는 AI Agent가 응답하는 번호가 표시되며, Meta가 표시 이름을 아직 검토 중인지, Meta 테스트 번호인지, 또는 첫 메시지가 아직 도착하지 않았는지 설명됩니다. 각 카드는 WhatsApp Manager의 올바른 위치로 연결됩니다.
- 경고가 연결 자체에 관한 것이라면 패널에서 Reconnect WhatsApp을 클릭하세요. 대부분의 경우 이 작업으로 해결됩니다.
- 해결되지 않으면 번호가 다른 제공업체에 연결되어 있을 수 있습니다. Meta는 한 번에 WhatsApp 계정당 하나의 파트너만 허용합니다. 화면의 안내에 따라 Meta Business 설정에서 Quickchat AI를 파트너로 추가한 다음 Refresh Status를 클릭하세요.
잘못된 계정을 연결했습니다.
- Reconnect는 이미 연결된 계정을 유지합니다. 전환하려면 WhatsApp 패널에서 Disconnect를 클릭한 다음 다시 Connect WhatsApp을 클릭하고 Meta 창에서 올바른 Meta Business 계정과 WhatsApp Account를 선택하세요.
메시지가 Quickchat AI Inbox에 표시되지 않습니다.
- 팝업에 WhatsApp 계정이 연결되었다는 최종 확인이 표시되었는지 확인하세요.
- 의도한 WhatsApp Account를 연결했는지, 올바른 AI Agent가 선택되어 있는지 다시 확인하세요.
- Waiting for your first message 카드는 AI Agent가 응답하는 번호를 표시합니다. 정확히 그 번호로 메시지를 보냈고 패널에서 켜져 있는지 확인한 다음 Refresh를 클릭하세요.
- 사용자 메시지 없이 24시간 이후에 메시지를 보내는 경우 승인된 템플릿을 사용하고 WhatsApp Manager에 결제 수단이 설정되어 있는지 확인하세요.
AI의 WhatsApp 답변 전송에 실패합니다.
- Quickchat AI는 WhatsApp 패널에 “WhatsApp replies are failing” 알림을 표시하고 대시보드에 알림을 표시합니다. 일반적인 해결 방법은 다음과 같습니다. WhatsApp Manager에서 display-name approval을 완료하세요. 연결이 만료되었거나 취소된 경우 Reconnect를 클릭하세요. 품질 또는 정책 문제로 Meta가 번호를 제한한 경우 WhatsApp Manager에서 상태를 확인하세요. 답변이 다시 성공적으로 전송되면 알림이 사라집니다.
템플릿 또는 비즈니스 시작 메시지가 실패합니다.
- Message Templates가 승인되었고 WhatsApp Manager에서 결제 수단이 활성 상태인지 확인하세요.
- 신규 발신자는 품질과 인증에 따라 확장되는 메시징 한도로 시작합니다. 비즈니스 시작 메시지에서 한도에 도달하면 Meta의 Messaging Limits 가이드를 검토하세요.
- 전달이 제한되는 경우 WhatsApp Manager에서 메시징 한도와 품질 등급을 확인하세요.
자체 WhatsApp 링크와 “Chat on WhatsApp” 버튼은 어떻게 만들 수 있나요?
- 이 WhatsApp 튜토리얼을 따르세요.
자체 WhatsApp QR 코드는 어떻게 만들 수 있나요?
- WhatsApp Manager로 이동 → Phone numbers → 비즈니스 전화번호 선택 → Message links → Create Message Link를 클릭하세요.
- 또는 WhatsApp Business 모바일 앱에서도 찾을 수 있습니다. 이 WhatsApp 튜토리얼을 따르세요.
도움이 필요하신가요?
WhatsApp에서 Quickchat의 Support AI와 채팅하세요.
📱 +1 302-405-9992: 채팅 시작
또는 QR 코드를 스캔하세요.
