계정과 연동

외부 시스템 또는 어시스턴트 연결

Pro 또는 Agency에서 권한이 제한된 키를 만들어 최신 콘텐츠를 게시하거나 어시스턴트를 연결하세요.

시작하기 전에

웹훅은 WhatsApp 서비스에서 수신 메시지 알림을 받습니다. 서버 설정은 연동 담당자의 작업이며 대시보드 사용자는 변경할 필요가 없습니다. MCP는 어시스턴트가 계정 도구를 요청하게 합니다.

진행 방법

수신 메시지에는 설정의 Webhook URL을 찾으세요.
복사로 계정 배포의 정확한 주소를 얻으세요.
담당자에게 원하는 기기의 수신 이벤트를 그 주소로 설정해 달라고 요청하세요.
준비 확인 후 본인 번호에서 받는 테스트 메시지를 준비하세요.
해당 자동 답장이나 로그가 켜진 그룹의 새 메시지 기록 같은 예상 결과를 확인하세요.
어시스턴트 연결에는 MCP 클라이언트가 연 승인 화면에서 로그인하세요.
권한 승인 전에 앱 이름과 계정을 확인하세요.
외부 전송을 연동하려면 설정 → 외부 연동을 여세요. 연결된 계정 하나와 명시적으로 선택한 그룹에 대해 이름이 있는 키를 만드세요. 키는 한 번만 표시되므로 즉시 저장하세요. API 기본 URL을 복사하세요.
예시: America/Sao_Paulo 시간대의 매일 여덟 번 게시 시각마다 최신 콘텐츠를 생성하도록 Abacus.AI를 설정하세요. 게시할 때마다 새로운 Idempotency-Key로 허용된 세 그룹에 요청을 제출하세요. 완전히 동일한 요청을 재시도할 때만 같은 키를 사용하세요.
scheduled_at을 생략하면 즉시 대기열에 추가됩니다. 예약하려면 -03:00 또는 Z (UTC)가 포함된 절대 타임스탬프를 최대 30일 후까지 지정하세요. 처리기는 매분 확인합니다. scheduled_at은 처리가 가능한 가장 이른 시각이며 정확한 초 단위 전달을 보장하지 않습니다.
재시도 전에 작업 상태와 그룹별 결과를 확인하세요. 아직 발송되지 않은 전송만 취소하세요. 노출된 키는 설정에서 폐기하고 대체 키를 만들어 저장하세요. 새 키로 이전 작업이 재개되지는 않습니다.

전체 예시

자리표시자가 있는 요청입니다. 보내기 전에 ID를 바꾸고 미래 날짜를 선택하세요. 이 요청은 실제 메시지를 게시합니다. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

결과 확인 방법

작업 접수와 그룹별 접수 결과는 게이트웨이가 접수했음을 뜻합니다. 전달이나 읽음을 확인하지 않습니다. 접근 권한, 키, 계정 또는 그룹 권한이 바뀌면 예약 작업이 차단될 수 있습니다.

알아둘 사항

어시스턴트는 노출된 기록을 읽고 요청받으면 텍스트를 보낼 수 있습니다. 전송 요청 전에 어시스턴트 도구 안내서를 보세요.
MCP에서 제공하지 않는 편집은 대시보드를 사용하세요.
Pro 및 Agency 월간 또는 연간 요금제에는 API 이용 권한이 포함됩니다. Starter는 업그레이드가 필요합니다. 키는 선택한 계정과 그룹만 허용하며 WhatsApp 계정을 교체하면 전송이 차단됩니다. 서버 인증 정보는 절대 공유하지 마세요.
텍스트는 4,096자, 설명은 1,024자까지 지원합니다. 최대 5 MiB의 JPEG, PNG 또는 WebP를 multipart 필드 payload와 image로 업로드하세요. 원격 이미지 URL은 사용할 수 없습니다.
새 작업은 HTTP 202를 반환합니다. 동일한 Idempotency-Key로 같은 요청을 재시도하면 원래 작업과 HTTP 200을 반환합니다. 같은 키로 다른 내용을 보내면 409를 반환합니다. 발송 후 시간 초과가 발생하면 결과가 미확인 상태일 수 있습니다. 다른 키로 자동 재제출하지 마세요.

자주 발생하는 문제

화면에 보이는 현상: 테스트 후 답장이나 새 기록이 없습니다.
해결 방법: 기기 연결과 해당 규칙 또는 로그를 확인한 뒤 담당자에게 수신 이벤트 설정을 확인 요청하세요.
예상 결과: 올바른 기능이 새 일치 이벤트를 처리할 수 있습니다.

화면에 보이는 현상: 어시스턴트가 승인되지 않거나 다른 계정입니다.
해결 방법: 로그인으로 돌아가 원하는 계정을 고르고 반복 승인 오류를 담당자에게 알리세요.
예상 결과: 승인 화면과 반환 기록이 원하는 계정에 속합니다.

추가 도움 받기

기능과 오류를 담당자에게 알려 주세요. 서버 자격 증명은 어시스턴트 대화에 넣지 마세요.

이 기능 열기