Quay lại bảng thuật ngữ

Green API Cho WhatsApp: Cách Kết Nối Và Gửi Tin Nhắn Tự Động Qua API

Green API (viết cách điệu là GREEN-API) là API HTTP của bên thứ ba dành cho WhatsApp. Dịch vụ này kết nối với một tài khoản WhatsApp hoặc WhatsApp Business thông thường, cho phép code của bạn gửi tin nhắn, nhận tin nhắn và phản hồi các sự kiện. Bài viết giải thích cách Green […]

Green API (viết cách điệu là GREEN-API) là API HTTP của bên thứ ba dành cho WhatsApp. Dịch vụ này kết nối với một tài khoản WhatsApp hoặc WhatsApp Business thông thường, cho phép code của bạn gửi tin nhắn, nhận tin nhắn và phản hồi các sự kiện. Bài viết giải thích cách Green API hoạt động, các tính năng chính, điểm khác nhau giữa Green API và GREEN-API: WABA, những giới hạn cần biết trước khi bắt đầu và cách vận hành phía WhatsApp khi bạn dùng nhiều số.

Lập trình viên thường dùng Green API để kết nối WhatsApp với CRM, helpdesk, chatbot và các quy trình no-code. Dịch vụ hoạt động mà không cần tham gia WhatsApp Business Platform chính thức của Meta.

Tóm tắt nhanh: Green API biến một tài khoản WhatsApp thành một cổng kết nối có thể lập trình, gọi là instance. Bạn liên kết tài khoản bằng mã QR hoặc mã liên kết qua số điện thoại, sau đó gọi các phương thức REST hoặc nhận webhook. Mỗi instance chỉ phục vụ một số, nên mỗi tài khoản bổ sung cần một instance và một số điện thoại riêng.

Khi số lượng số WhatsApp tăng lên, mỗi tài khoản vẫn cần một thiết bị chạy ứng dụng chính thức. Multilogin là nền tảng điện thoại Android đám mây để quản lý nhiều tài khoản: bạn có thể đặt mỗi tài khoản WhatsApp trên một điện thoại đám mây riêng, với dữ liệu ứng dụng, vị trí và IP riêng, thay vì duy trì cả dàn điện thoại thật. Thiết lập điện thoại đám mây miễn phí để bắt đầu.

Green API hoạt động như thế nào

Green API được xây dựng xoay quanh instance: một cổng kết nối gắn với đúng một tài khoản WhatsApp.

  1. Tạo instance trong bảng điều khiển (console) của Green API. Bạn sẽ nhận được idInstance và apiTokenInstance, dùng để xác thực mọi request.
  2. Liên kết tài khoản. Instance tham gia vào tài khoản WhatsApp của bạn dưới dạng một thiết bị liên kết. Quét mã QR trong WhatsApp > Thiết bị đã liên kết (Linked Devices), hoặc yêu cầu mã để liên kết bằng số điện thoại. Mã QR được làm mới sau mỗi 20 giây.
  3. Gửi request. Gọi các phương thức HTTP theo định dạng {apiUrl}/waInstance{idInstance}/{method}/{apiTokenInstance}.
  4. Nhận sự kiện. Lấy các thông báo đến qua HTTP API, hoặc để Green API đẩy chúng tới endpoint webhook của bạn.

Tài khoản WhatsApp phải được tạo sẵn từ trước. Hãy đăng ký tài khoản trong ứng dụng WhatsApp hoặc WhatsApp Business chính thức bằng một số điện thoại có thể nhận mã xác minh.

Green API cung cấp những tính năng gì

  • Nhắn tin: văn bản, hình ảnh, video, âm thanh và tài liệu dung lượng tối đa 100 MB, cùng vị trí, danh bạ, khảo sát (poll) và nút tương tác.
  • Nhóm và trạng thái: tạo nhóm, quản lý thành viên, đăng trạng thái và xem thống kê trạng thái.
  • Kiểm tra số: xác nhận một số điện thoại có dùng WhatsApp hay không trước khi nhắn tin.
  • Lịch sử tin nhắn: nhật ký tin nhắn đã gửi và đã nhận.
  • SDK: Python, Node.js, PHP, Go, Java, C++, 1C và HTML, cùng một contract gRPC.
  • Tích hợp: n8n, Make, Zapier, Slack, GoHighLevel, MS Excel và nhiều công cụ khác.
  • Chatbot AI: thư viện chatbot GPT dựng sẵn cho Python, Go và Node.js.

Cùng công ty này còn cung cấp GREEN-API: WABA (xây dựng trên WhatsApp Business API chính thức) và Telegram API.

So sánh Green API và GREEN-API: WABA

Green API GREEN-API: WABA
Cách kết nối Thiết bị liên kết trên một tài khoản WhatsApp có sẵn WhatsApp Business API chính thức
Mô hình chi phí Phí cố định cho mỗi instance Gói đăng ký cộng phí theo từng tin nhắn, tùy danh mục
Gửi tin nhắn chủ động Tin nhắn thông thường Tin nhắn mẫu (template); khung 24 giờ chỉ mở ra sau khi khách hàng nhắn trước

Chọn sản phẩm dạng thiết bị liên kết khi bạn cần tích hợp nhanh và chi phí cố định thấp. Chọn WABA khi bạn cần kênh chính thức của Meta và chấp nhận các quy tắc về tin nhắn mẫu.

Khi nào bạn cần dùng Green API

  • Tích hợp CRM và helpdesk: đưa các cuộc hội thoại WhatsApp vào những công cụ đội ngũ của bạn đang dùng.
  • Chatbot: tự động trả lời các câu hỏi thường gặp, kể cả phản hồi dựa trên GPT.
  • Thông báo giao dịch: gửi cập nhật đơn hàng, lời nhắc hoặc mã thay cho SMS.
  • Thu thập khách hàng tiềm năng: đẩy lead mới từ WhatsApp vào các quy trình n8n, Make hoặc Zapier.
  • Đội ngũ dùng nhiều số: agency và bộ phận chăm sóc khách hàng chạy một instance cho mỗi khách hàng hoặc mỗi số theo khu vực.

Những giới hạn cần biết trước khi bắt đầu

  • Đây không phải Business Platform chính thức. WhatsApp có thể hạn chế những số gửi tin nhắn hàng loạt hoặc tin nhắn người nhận không yêu cầu. Vì vậy, Green API công bố riêng các khuyến nghị về làm nóng (warm-up) số và gửi tin nhắn hàng loạt.
  • Một instance, một số. Mười số đồng nghĩa với mười instance và mười gói trả phí.
  • Phía điện thoại vẫn quan trọng. Mỗi tài khoản nằm trong ứng dụng chính thức trên một chiếc điện thoại. Tài liệu thiết lập của Green API khuyên giữ điện thoại đó luôn có pin và kết nối mạng.
  • Bắt buộc có số điện thoại. Green API không cung cấp số; bạn cần tự chuẩn bị số của mình.

Vận hành phía WhatsApp khi mở rộng quy mô

Green API xử lý phần logic nhắn tin. Mỗi tài khoản vẫn cần một thiết bị chạy ứng dụng chính thức và luôn sẵn sàng hoạt động.

Đội ngũ quản lý nhiều số có thể đặt mỗi tài khoản WhatsApp trên một điện thoại đám mây Multilogin cho WhatsApp riêng. Mỗi điện thoại đám mây là một thiết bị Android thật trên đám mây, có dữ liệu ứng dụng, vị trí và IP riêng, nên bạn không phải duy trì cả kệ điện thoại thật lúc nào cũng sạc pin và kết nối mạng.

Để thêm số mới, hãy làm theo hướng dẫn tạo nhiều tài khoản WhatsApp. Điện thoại đám mây Multilogin không thể nhận SMS hoặc cuộc gọi, vì vậy mã đăng ký phải được gửi tới một số bạn kiểm soát, chẳng hạn điện thoại của chính bạn hoặc một nhà cung cấp SMS bên ngoài.

Thiết lập mạng cũng quan trọng, nhất là khi các số thuộc những khu vực khác nhau. Proxy WhatsApp giúp mỗi tài khoản có IP riêng. Mọi gói Multilogin đều có sẵn proxy dân cư tích hợp, nên mỗi hồ sơ có IP riêng và vị trí tương ứng.

Mọi người cũng hỏi

Green API là gì?

Green API (GREEN-API) là API HTTP của bên thứ ba dành cho WhatsApp. Dịch vụ kết nối với một tài khoản WhatsApp hoặc WhatsApp Business thông thường dưới dạng thiết bị liên kết, cho phép bạn gửi và nhận tin nhắn, phản hồi sự kiện, đồng thời tích hợp WhatsApp với CRM, helpdesk, chatbot hoặc các công cụ no-code như n8n, Make, Zapier.

Green API có phải là WhatsApp Business API chính thức không?

Không. Green API hoạt động mà không cần tham gia WhatsApp Business Platform chính thức của Meta. Nếu bạn cần kênh chính thức, cùng công ty có sản phẩm GREEN-API: WABA, xây dựng trên WhatsApp Business API, tính phí theo gói đăng ký cộng phí theo từng tin nhắn và áp dụng quy tắc tin nhắn mẫu.

Một instance Green API dùng được cho bao nhiêu số WhatsApp?

Mỗi instance chỉ gắn với một số WhatsApp. Nếu bạn vận hành 10 số, bạn cần 10 instance và 10 gói trả phí tương ứng. Green API cũng không cung cấp số điện thoại, nên bạn cần tự chuẩn bị số cho từng tài khoản.

Dùng Green API có khiến số WhatsApp bị hạn chế không?

Có rủi ro, vì Green API không phải nền tảng chính thức. WhatsApp có thể hạn chế những số gửi tin nhắn hàng loạt hoặc tin nhắn người nhận không yêu cầu. Để giảm rủi ro, hãy tham khảo khuyến nghị làm nóng (warm-up) số và gửi tin hàng loạt mà Green API công bố, đồng thời chỉ nhắn tin cho những người đã đồng ý nhận.

Có thể dùng điện thoại đám mây Multilogin cho các tài khoản WhatsApp kết nối với Green API không?

Có. Mỗi tài khoản WhatsApp vẫn cần một thiết bị chạy ứng dụng chính thức, và bạn có thể đặt mỗi tài khoản trên một điện thoại đám mây Multilogin riêng, tức một thiết bị Android thật trên đám mây với dữ liệu ứng dụng, vị trí và IP riêng. Lưu ý rằng điện thoại đám mây Multilogin không nhận được SMS hoặc cuộc gọi, nên mã đăng ký WhatsApp phải được gửi tới một số bạn kiểm soát, như điện thoại của bạn hoặc một nhà cung cấp SMS bên ngoài. Multilogin có gói miễn phí không giới hạn thời gian, không cần thẻ tín dụng; gói trả phí từ $7.08/tháng.

Vận hành không giới hạn tài khoản mà không bị khóa

Vận hành tài khoản mạng xã hội trên cloud phone và trình duyệt web

Thử miễn phí