integrate-whatsapp

integrate-whatsapp 개요

integrate-whatsapp가 하는 일

integrate-whatsapp 스킬은 Kapso로 WhatsApp을 제품에 연결하는 작업을, 고객 온보딩부터 메시지 전송까지 한 흐름으로 도와줍니다. 설정 링크, 연결 감지, 웹훅, 템플릿 전송, 미디어, WhatsApp Flows까지 한 번에 다루는 integrate-whatsapp 가이드가 필요할 때 특히 유용합니다.

가장 잘 맞는 사용 사례

다음이 필요한 백엔드 시스템이라면 이 integrate-whatsapp skill을 사용하세요:

• 고객을 각자의 WhatsApp Business 계정으로 온보딩해야 할 때
• 번호가 연결 상태가 되었는지 감지해야 할 때
• 웹훅으로 메시지 및 대화 이벤트를 받아야 할 때
• 외부 메시지, 템플릿, 미디어를 전송해야 할 때
• Flows 엔드포인트, 암호화, 게시 단계를 관리해야 할 때

이 스킬을 설치할 가치가 있는 이유

가장 큰 장점은 워크플로우가 완결되어 있다는 점입니다. 이 저장소는 CLI 우선 방식과 API 우선 방식 모두에 대해 실용적인 경로를 제공하므로, 환경이 아직 바뀌는 중이거나 멀티 테넌트 지원이 필요할 때 특히 도움이 됩니다. integrate-whatsapp install을 검토 중이라면, 이 스킬은 단순한 프롬프트보다 훨씬 강력합니다. 보통 실제 운영을 막는 요소들인 ID, 웹훅 라우팅, 설정 링크의 수명 주기, 프로젝트 수준 작업과 전화번호 수준 작업의 차이까지 함께 담고 있기 때문입니다.

integrate-whatsapp 스킬 사용 방법

설치하고 문맥을 먼저 확인하기

npx skills add gokapso/agent-skills --skill integrate-whatsapp로 설치하세요. 구현 도움을 요청하기 전에 프로젝트에서 저장소 문맥이 맞는지 확인하고 SKILL.md를 먼저 읽으세요. 그다음 references/getting-started.md, references/platform-api-reference.md, references/webhooks-overview.md, references/setup-links.md를 살펴보면, 자산 파일만 빠르게 훑는 것보다 실제 통합 경로를 훨씬 더 잘 이해할 수 있습니다.

대략적인 목표를 쓸 만한 프롬프트로 바꾸기

가장 좋은 integrate-whatsapp usage를 원한다면 다음을 구체적으로 적어 주세요:

• Kapso CLI를 쓰는지, 직접 API 호출을 쓰는지
• 앱이 멀티 테넌트인지, 단일 번호인지
• 막힌 단계가 무엇인지: 온보딩, 연결 감지, 웹훅 처리, 전송, Flows 중 어디인지
• 이미 가지고 있는 정확한 객체: customer_id, phone_number_id, business_account_id, 웹훅 시크릿 등

좋은 프롬프트 예시는 다음과 같습니다:

멀티 테넌트 SaaS용 WhatsApp 온보딩을 구현해 주세요. customer_id는 이미 있고, setup-link 흐름이 필요합니다. whatsapp.phone_number.created에 대한 웹훅 확인과 phone_number_id를 사용하는 메시지 전송 경로도 필요합니다.

먼저 읽어야 할 파일과 워크플로우

구현 선택을 좌우하는 파일부터 읽으세요:

• 전체 흐름을 파악하려면 references/getting-started.md
• 연결 이벤트와 리디렉션 처리는 references/detecting-whatsapp-connection.md
• 이벤트 전달 규칙과 서명 검증은 references/webhooks-reference.md와 references/webhooks-overview.md
• 템플릿이나 미디어를 보낼 때는 references/templates-reference.md
• Flows가 필요하면 references/whatsapp-flows-spec.md와 assets/sample-flow.json

초반에 함께 살펴볼 만한 유용한 자산은 다음과 같습니다:

• assets/webhooks-example.json
• assets/dynamic-flow.json
• assets/send-template-order-status-update.json
• assets/send-interactive-buttons.json

실무에서 바로 쓰는 팁

프로젝트 상태, 고객, 번호를 탐색할 때는 CLI를 우선 사용하고, 자체 백엔드에 통합할 때는 raw API 호출을 사용하세요. setup-link 온보딩과 메시지 전송은 혼동하지 마세요. 온보딩은 연결된 번호를 생성하거나 찾아내는 과정이고, 전송에는 올바른 phone_number_id가 필요합니다. 이 구분은 성공적인 integrate-whatsapp usage의 핵심이며, 대부분의 통합 오류를 막아줍니다.

integrate-whatsapp 스킬 FAQ

이 스킬은 백엔드 개발용인가요?

네, 이 integrate-whatsapp for Backend Development 스킬은 주로 백엔드 작업에 맞춰져 있습니다. 서버 측 온보딩, 웹훅 처리, API 인증, 메시지 오케스트레이션에 적합합니다. UI 문구 작성용도 아니고, 마케팅 콘텐츠용 단순 프롬프트 템플릿도 아닙니다.

일반 프롬프트와는 무엇이 다른가요?

일반 프롬프트는 WhatsApp 통합을 대개 모호하게 설명합니다. 반면 integrate-whatsapp skill은 실제 통합 표면인 setup-link, 웹훅 이벤트, 번호 확인, WhatsApp Flows를 반영한다는 점에서 더 유용합니다. 그래서 예시 수준이 아니라 배포 가능한 결과가 필요할 때 추측을 줄여줍니다.

사용하려면 Kapso CLI가 꼭 필요한가요?

아니요. 다만 스킬 안에서는 CLI가 프로젝트 선택, 설정, 번호 탐색에 도움이 되기 때문에 선호 경로입니다. 팀에서 CLI 도구를 사용할 수 없다면, 참조 문서는 여전히 X-API-Key를 통한 직접 API 호출을 지원합니다.

언제 integrate-whatsapp를 쓰지 말아야 하나요?

단순히 WhatsApp 제품에 대한 고수준 개요만 원한다면 이 스킬은 건너뛰세요. 또는 전혀 다른 제공업체와 연동하고 있고 Kapso 플랫폼 API를 사용할 계획이 없다면 맞지 않습니다. 온보딩이나 웹훅 없이 일회성 메시지 예시만 필요할 때도 좋은 선택은 아닙니다.

integrate-whatsapp 스킬을 개선하는 방법

스킬에 시작 상태를 정확히 알려 주기

가장 좋은 개선은 실제 통합 상태를 제공하는 데서 나옵니다. 현재 프로젝트 ID, 고객이 이미 존재하는지 여부, 보유한 웹훅 엔드포인트, 전송해야 하는 메시지 유형을 알려 주세요. 이렇게 하면 integrate-whatsapp install 결과가 더 실행 가능해집니다. 스킬이 설정을 처음부터 되풀이하는 대신, 워크플로우가 어디서 시작되는지 기준으로 판단할 수 있기 때문입니다.

실패 지점을 명확히 적기

더 좋은 결과를 원한다면 막힌 부분을 이름으로 적으세요:

• “setup link는 열리지만 phone number가 생성되지 않음”
• “webhook은 도착하지만 signature verification이 실패함”
• “template send는 테스트에서는 되는데 production에서는 안 됨”
• “phone_number_id가 잘못됨”

이런 입력은 막연하게 통합 계획을 요청하는 것보다 훨씬 유용한 integrate-whatsapp usage 안내를 만들어냅니다.

반복 개선에는 적절한 산출물을 사용하기

첫 결과가 불완전하다면 다음 중 하나를 붙여서 다시 시도하세요:

• 받은 webhook payload
• 보내려는 template JSON
• publish하려는 Flow JSON
• kapso status, kapso whatsapp numbers list의 명령 출력 또는 API 응답

integrate-whatsapp guide 작업에서는 이런 산출물이 광범위한 요구사항보다 더 중요합니다. ID, 이벤트 이름, 리디렉션 처리, payload 형식을 빠르게 바로잡을 수 있기 때문입니다.

운영에서 자주 하는 실수를 조심하기

가장 흔한 실패는 잘못된 식별자를 쓰거나, 잘못된 webhook type에 구독하거나, setup 완료가 곧바로 메시지 전송 가능 상태를 뜻한다고 가정하는 것입니다. 프로젝트 웹훅이 필요한지, phone-number 웹훅이 필요한지, Kapso를 쓰는지 Meta proxy endpoints를 쓰는지, 앱이 coexistence 모드를 지원해야 하는지 dedicated mode가 필요한지 명시하면 스킬 출력의 품질을 높일 수 있습니다.