Skip to main content
문서가이드WhatsApp

WhatsApp 비즈니스 API

WhatsApp 번호를 BeeCastly에 연결해 고객과 채팅하고, AI가 대신 답하게 하고, 브로드캐스트를 보내세요. QR 코드를 스캔하거나 공식 Meta WhatsApp Cloud API로 연결할 수 있어요.

사전 준비 사항

BeeCastly 계정(무료 플랜도 가능)
Meta Business 계정(business.facebook.com)
Cloud API 방식의 경우: Meta Business 계정(business.facebook.com)과 Meta에 등록할 전화번호

연결 방법 두 가지

QR 코드 스캔

WhatsApp Web처럼 이미 쓰고 있는 번호(WhatsApp Business 앱 번호 포함)를 연결해요. 무료이고 Meta 승인이 필요 없어요. 답장과 자동 답장에 가장 적합해요. 대량 브로드캐스트에는 사용하지 마세요. WhatsApp이 번호를 차단할 수 있어요.

WhatsApp Cloud API (Meta)

Meta의 공식 방식이에요. Meta Business 계정과 승인된 메시지 템플릿이 필요해요. 브로드캐스트와 캠페인에는 이 방식을 사용하세요.

설정 가이드

1BeeCastly에서 WhatsApp 연결하기

연동 → 채널 → WhatsApp으로 이동하세요.
QR 코드: WhatsApp QR을 선택하세요. 휴대폰에서 WhatsApp → 연결된 기기 → 기기 연결을 열고 코드를 스캔하세요. 휴대폰은 평소처럼 계속 작동해요.
Cloud API: WhatsApp Cloud API (Meta)를 선택하고 Facebook으로 연결을 클릭하세요. Meta Business 계정과 전화번호를 고르세요. 직접 설정하려면 단계별 마법사가 Meta 앱 ID, WhatsApp Business 계정 ID, 전화번호 ID, 액세스 토큰을 물어봐요.

2메시지 템플릿 만들기

Cloud API에서는 고객의 마지막 메시지 후 24시간 이내에만 자유 텍스트를 보낼 수 있어요. 그 시간이 지나면 Meta가 승인한 템플릿이 필요해요.
캠페인 → 템플릿으로 이동해 템플릿을 만드세요.
카테고리를 고르세요. 마케팅, 유틸리티, 인증 중 하나예요.
이름과 기타 정보를 위해 {{1}}, {{2}} 같은 변수를 추가하세요.
제출하세요. Meta가 검토하고 상태는 BeeCastly에서 업데이트돼요.

3브로드캐스트 캠페인 발송하기

캠페인 → 브로드캐스트 → 만들기로 이동하세요.
채널로 WhatsApp을 선택하세요.
승인된 템플릿과 발송 대상(연락처, 태그 또는 세그먼트)을 고르세요.
템플릿 변수를 연락처 필드(이름, 전화번호, 사용자 지정 필드)에 매핑하세요.
메시지를 미리 본 뒤 지금 보내기 또는 예약을 클릭하세요.

4대화 관리하기

수신 WhatsApp 메시지는 메시지 → WhatsApp(그리고 모든 메시지)에 들어와요.
받은편지함에서 답하고, 자주 보내는 답변에는 빠른 답장을 쓰고, 채팅을 팀원에게 배정하세요.
AI 답변을 켜면 챗봇이 지식 베이스를 바탕으로 자주 묻는 질문에 답하고, 필요할 때 사람에게 넘겨요.

5더 많은 WhatsApp 도구

메시지 → Status Studio: WhatsApp 상태를 게시하세요.
메시지 → wa.me 링크: 웹사이트와 포스터용 클릭 투 챗 링크나 QR 코드를 만드세요.
연동 → 채널 → WhatsApp: 비즈니스 프로필과 상품 카탈로그를 수정하세요 (Cloud API).

모범 사례

높은 품질 등급을 유지하세요

스팸을 피해 메시지 품질 등급을 높게 유지하세요. 사용자가 차단하거나 신고하면 Meta가 발송 한도를 제한할 수 있습니다.

수신 동의를 받으세요

마케팅 메시지를 보내기 전에 양식, 웹사이트 채팅, 대면 등으로 분명한 동의를 받으세요.

인공지능 자동 응답을 현명하게 활용하세요

지식 베이스에 가격, 영업시간, 정책이 있을 때 AI 답변이 가장 잘 작동해요. 고객이 사람에게 연락할 방법은 항상 남겨 두세요.

중요: 24시간 창 (Cloud API)

WhatsApp Cloud API에서는 고객의 마지막 메시지 후 24시간 이내에만 자유 텍스트를 보낼 수 있어요. 이 시간이 지나면 승인된 템플릿을 사용해야 해요.

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly