All-in-One Messenger Hub
API 연동 가이드
간단한 API를 통해 WhatsApp 메시지를 보낼 수 있도록 CRM, 예약 시스템 또는 모든 애플리케이션을 연결하세요.
간단한 5단계로 시작하기
데스크톱 앱 다운로드하기
Windows 컴퓨터에 All-in-One Messenger Hub를 다운로드하여 설치하세요.
WhatsApp 연결하기
QR 코드를 스캔하여 앱에 WhatsApp 계정을 추가하세요.
Session API 만들기
WhatsApp 탭으로 이동하여 새 Session API를 만드세요. 이를 WhatsApp 채널에 연결하세요.
API 키 복사하기
생성된 API 키를 복사하세요. 인증 정보이므로 안전하게 보관하세요.
메시지 보내기 시작하기
애플리케이션에서 API를 사용하세요. 메시지를 전달하려면 데스크톱 앱을 계속 실행하세요.
인증
모든 API 엔드포인트는 API 키를 통한 인증이 필요합니다. 다음 방법 중 하나로 키를 전달할 수 있습니다:
| 방법 | 예시 |
|---|---|
| X-API-Key 헤더(권장) | X-API-Key: your-api-key |
| 쿼리/본문 매개변수 | key=your-api-key |
| 대체 매개변수 | api_key=your-api-key |
메시지 보내기
전화번호 또는 그룹으로 WhatsApp 메시지를 보냅니다. 메시지는 대기열에 저장되며 데스크톱 앱이 실행 중일 때 전달됩니다.
POST https://onemessengerhub.com/api/whatsapp-session/send매개변수
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
key |
string | 예 | 데스크톱 앱에서 발급받은 API 키 |
mobile |
string | 조건부 | 국가 코드가 포함된 전화번호(group_id가 없으면 필수) |
group_id |
string | 조건부 | WhatsApp 그룹 ID(mobile이 없으면 필수). @g.us 접미사는 자동으로 추가됩니다. |
message |
string | 예 | 메시지 텍스트(최대 4096자) |
요청 예시
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"mobile": "1234567890", "message": "Hello!"}'간단한 GET 요청(브라우저 또는 링크)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!성공 응답(201)
{ "success": true, "message": "Message queued successfully", "data": { "message_id": 123, "recipient": "1234567890", "status": "pending" }}연락처 저장
WhatsApp에 연락처를 저장하거나 이름을 변경합니다. 작업은 대기열에 저장되어 데스크톱 앱에서 처리됩니다.
POST https://onemessengerhub.com/api/whatsapp-session/save-contact매개변수
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
key |
string | 예 | 데스크톱 앱에서 발급받은 API 키 |
contact_id |
string | 예 | 연락처 전화번호 또는 WhatsApp ID(최대 50자). @c.us 접미사는 자동으로 추가됩니다. |
name |
string | 예 | 연락처의 표시 이름(최대 255자) |
요청 예시
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890", "name": "John Doe"}'성공 응답(201)
{ "success": true, "message": "Contact save operation queued", "data": { "operation_id": 456, "contact_id": "[email protected]", "status": "pending" }}연락처 삭제
WhatsApp에서 연락처를 삭제합니다. 작업은 대기열에 저장되어 데스크톱 앱에서 처리됩니다.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contact매개변수
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
key |
string | 예 | 데스크톱 앱에서 발급받은 API 키 |
contact_id |
string | 예 | 연락처 전화번호 또는 WhatsApp ID(최대 50자). @c.us 접미사는 자동으로 추가됩니다. |
요청 예시
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contact_id": "1234567890"}'성공 응답(201)
{ "success": true, "message": "Contact remove operation queued", "data": { "operation_id": 789, "contact_id": "[email protected]", "status": "pending" }}오류 처리
API는 표준 HTTP 상태 코드를 사용합니다. 일반적인 오류 응답은 다음과 같습니다:
인증 오류(401)
{ "success": false, "message": "Invalid or inactive API key"}유효성 검사 오류(422)
{ "success": false, "message": "Validation failed", "errors": { "mobile": ["The mobile field is required when group id is not present."], "message": ["The message field is required."] }}만들 수 있는 것들
CRM 연동
CRM 시스템에서 직접 후속 메시지, 알림, 업데이트를 보내세요.
예약 확인
고객에게 예약 확인 및 알림을 자동으로 보내세요.
주문 알림
주문 상태, 배송 업데이트, 배송 정보에 대해 고객에게 알리세요.
경고 시스템
팀이나 고객에게 중요한 경고와 알림을 보내세요.
마케팅 캠페인
연락처 목록에 프로모션 메시지와 업데이트를 보내세요.
사용자 지정 워크플로
Zapier, Make, n8n 또는 모든 자동화 플랫폼과 연동하세요.
더 많은 API 출시 예정
더 많은 플랫폼과 사용 사례를 다루기 위해 API 제공 범위를 확장하고 있습니다.
Chatbot API
프로그래밍 방식으로 챗봇 응답을 트리거하고 대화를 관리하세요.
Contacts API
플랫폼 전반에 걸쳐 메신저 연락처에 액세스하고 관리하세요.
Webhooks
메시지가 수신되거나 전송될 때 실시간 알림을 받으세요.