integrate-whatsapp

Tổng quan về skill integrate-whatsapp

integrate-whatsapp làm gì

Skill integrate-whatsapp giúp bạn kết nối WhatsApp vào một sản phẩm với Kapso, từ onboarding khách hàng đến gửi tin nhắn. Skill này hữu ích nhất khi bạn cần một integrate-whatsapp guide bao quát liên kết thiết lập, phát hiện trạng thái kết nối, webhooks, gửi template, media và WhatsApp Flows trong cùng một quy trình.

Trường hợp sử dụng phù hợp nhất

Dùng integrate-whatsapp skill này cho các hệ thống backend cần:

• đưa khách hàng vào chính tài khoản WhatsApp Business của họ
• phát hiện khi một số điện thoại đã được kết nối
• nhận sự kiện tin nhắn và cuộc trò chuyện qua webhooks
• gửi tin nhắn outbound, template và media
• quản lý các endpoint cho Flows, mã hóa và các bước publish

Vì sao skill này đáng cài đặt

Ưu điểm lớn nhất là độ đầy đủ của workflow. Repository cung cấp các lộ trình thực tế cho cả tích hợp theo kiểu ưu tiên CLI lẫn ưu tiên API, điều này rất quan trọng nếu môi trường của bạn còn đang thay đổi hoặc nếu bạn cần hỗ trợ nhiều tenant. Nếu bạn đang cân nhắc một lần integrate-whatsapp install, skill này mạnh hơn một prompt chung chung vì nó bao gồm những mảnh ghép thường chặn công việc production: ID, routing webhook, vòng đời setup-link, và sự khác nhau giữa thao tác ở cấp project với cấp số điện thoại.

Cách sử dụng skill integrate-whatsapp

Cài đặt và xác nhận ngữ cảnh

Cài bằng npx skills add gokapso/agent-skills --skill integrate-whatsapp. Trước khi nhờ hỗ trợ triển khai, hãy xác nhận ngữ cảnh repository trong project của bạn và đọc SKILL.md trước. Sau đó xem tiếp references/getting-started.md, references/platform-api-reference.md, references/webhooks-overview.md, và references/setup-links.md vì chúng mô tả đúng đường tích hợp thực tế tốt hơn nhiều so với việc lướt nhanh assets.

Biến mục tiêu thô thành prompt có thể dùng được

Để integrate-whatsapp usage hiệu quả nhất, hãy mô tả rõ:

• bạn đang dùng Kapso CLI hay gọi API trực tiếp
• app là multi-tenant hay chỉ một số điện thoại
• bạn đang vướng ở bước nào: onboarding, phát hiện kết nối, xử lý webhook, gửi tin nhắn, hay Flows
• những object cụ thể bạn đã có, như customer_id, phone_number_id, business_account_id, hoặc webhook secret

Một prompt tốt sẽ trông như sau:

Implement WhatsApp onboarding for a multi-tenant SaaS. I already have customer_id, need a setup-link flow, webhook confirmation for whatsapp.phone_number.created, and a send-message path using phone_number_id.

Các file và workflow nên đọc trước

Bắt đầu với các file định hình lựa chọn triển khai:

• references/getting-started.md cho luồng end-to-end
• references/detecting-whatsapp-connection.md cho sự kiện kết nối và xử lý redirect
• references/webhooks-reference.md và references/webhooks-overview.md cho quy tắc truyền sự kiện và xác minh chữ ký
• references/templates-reference.md nếu bạn gửi template hoặc media
• references/whatsapp-flows-spec.md cùng assets/sample-flow.json nếu bạn cần Flows

Các asset nên xem sớm:

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

Mẹo sử dụng thực tế

Ưu tiên CLI khi bạn đang dò trạng thái project, khách hàng hoặc số điện thoại, và dùng raw API calls khi bạn nhúng tích hợp vào backend của chính mình. Đừng nhầm lẫn giữa onboarding bằng setup-link và việc gửi tin nhắn: onboarding dùng để tạo hoặc xác định số đã kết nối, còn gửi tin nhắn đòi hỏi phone_number_id chính xác. Phân biệt này là trọng tâm của integrate-whatsapp usage thành công và giúp tránh phần lớn lỗi tích hợp.

Câu hỏi thường gặp về skill integrate-whatsapp

Skill này chỉ dành cho Backend Development thôi à?

Đúng, integrate-whatsapp for Backend Development chủ yếu dành cho công việc backend. Nó phù hợp với onboarding phía server, xử lý webhook, xác thực API, và điều phối tin nhắn. Đây không phải skill viết UI copy, cũng không phải một prompt template thuần túy cho nội dung marketing.

Skill này khác gì so với một prompt bình thường?

Một prompt bình thường thường mô tả tích hợp WhatsApp khá chung chung. integrate-whatsapp skill hữu ích hơn vì nó phản ánh đúng bề mặt tích hợp thực tế: setup links, sự kiện webhook, giải quyết số điện thoại, và WhatsApp Flows. Nhờ đó bạn giảm được phần phải đoán mò khi cần một thứ có thể triển khai thật chứ không chỉ minh họa.

Tôi có cần Kapso CLI để dùng nó không?

Không, nhưng CLI là đường đi được ưu tiên trong skill này vì nó hỗ trợ chọn project, thiết lập, và tìm số điện thoại. Nếu team của bạn không thể dùng CLI tooling, các phần tham chiếu vẫn hỗ trợ gọi API trực tiếp thông qua X-API-Key.

Khi nào không nên dùng integrate-whatsapp?

Không nên dùng skill này nếu bạn chỉ muốn cái nhìn tổng quan cấp cao về sản phẩm WhatsApp, hoặc nếu bạn đang tích hợp với một nhà cung cấp hoàn toàn khác và không có ý định dùng platform APIs của Kapso. Nó cũng không phù hợp nếu bạn chỉ cần một ví dụ gửi tin nhắn một lần mà không có onboarding hoặc webhooks.

Cách cải thiện skill integrate-whatsapp

Cung cấp đúng trạng thái khởi đầu cho skill

Những cải thiện tốt nhất đến từ việc cung cấp trạng thái tích hợp thực tế: project ID hiện tại, khách hàng đã tồn tại hay chưa, endpoint webhook bạn đang sở hữu, và loại tin nhắn bạn cần gửi. Điều này làm cho kết quả integrate-whatsapp install hữu dụng hơn vì skill có thể suy luận bạn đang bắt đầu từ đâu thay vì chỉ nhắc lại thiết lập từ số 0.

Nói rõ mode lỗi

Nếu muốn kết quả tốt hơn, hãy nêu rõ điểm nghẽn:

• “setup link mở ra nhưng không tạo được phone number”
• “webhook đã về nhưng xác minh chữ ký thất bại”
• “template gửi được ở test nhưng không chạy ở production”
• “tôi đang dùng sai phone_number_id”

Loại đầu vào này sẽ tạo ra hướng dẫn integrate-whatsapp usage hữu ích hơn nhiều so với việc xin một kế hoạch tích hợp chung chung.

Dùng đúng artifact để lặp lại

Nếu đầu ra đầu tiên chưa đầy đủ, hãy lặp lại bằng một trong các thứ sau:

• webhook payload bạn đã nhận
• JSON template bạn muốn gửi
• JSON Flow bạn muốn publish
• output từ kapso status, kapso whatsapp numbers list, hoặc API response của bạn

Với công việc integrate-whatsapp guide, những artifact này quan trọng hơn yêu cầu ở mức rộng vì chúng cho phép bạn chỉnh nhanh ID, tên event, xử lý redirect, và shape của payload.

Chú ý các lỗi production thường gặp

Những lỗi phổ biến nhất là dùng sai định danh, subscribe nhầm loại webhook, hoặc cho rằng hoàn tất setup đồng nghĩa với việc có thể gửi tin nhắn ngay. Hãy cải thiện output của skill bằng cách nói rõ bạn cần project webhooks hay phone-number webhooks, bạn đang dùng Kapso hay Meta proxy endpoints, và app của bạn phải hỗ trợ coexistence hay dedicated mode.