Hướng dẫn toàn tập kết nối Facebook Graph API với n8n

Chia sẻ bởi Little Excel

Trong thời đại số, việc quản lý Fanpage Facebook hiệu quả và tiết kiệm thời gian là một ưu tiên hàng đầu. Bạn muốn tự động đăng bài, lấy bình luận, hay tương tác với người dùng một cách thông minh? Facebook Graph API chính là chìa khóa, và khi kết hợp với công cụ tự động hóa mạnh mẽ như n8n, khả năng của bạn gần như vô hạn.

Bài viết này sẽ hướng dẫn chi tiết cách kết nối Facebook Graph API với n8n, không chỉ dừng lại ở việc đăng bài tự động mà còn đi sâu vào các khía cạnh kỹ thuật quan trọng như access token, các loại quyền (permission), và chế độ hoạt động của ứng dụng (app mode). Dù bạn là người mới bắt đầu hay đã có kinh nghiệm, những thông tin này sẽ giúp bạn làm chủ công cụ và tối ưu hóa quy trình làm việc của mình.

Bước 1: Chuẩn bị "sân chơi" - Tạo tài khoản Facebook Developer và ứng dụng

Trước khi có thể "ra lệnh" cho Facebook thông qua API, chúng ta cần một danh tính chính thức trên nền tảng dành cho nhà phát triển của họ.

1. Đăng ký tài khoản Facebook Developer

Nếu bạn chưa có, hãy truy cập vào trang developer.facebook.com và tiến hành đăng ký. Quá trình này khá đơn giản:

1. Nhấn nút "Bắt đầu" (Get Started).
2. Đăng nhập bằng tài khoản Facebook cá nhân của bạn.
3. Facebook sẽ yêu cầu bạn xác minh một số thông tin, thường là số điện thoại. Hãy nhập số điện thoại của bạn và xác nhận mã OTP được gửi về.
4. Tiếp theo, bạn có thể cần xác nhận Email.
5. Hoàn tất các bước đăng ký cơ bản để truy cập vào trang quản lý ứng dụng.

2. Tạo ứng dụng (App) mới

Sau khi có tài khoản Developer, bạn cần tạo một "ứng dụng" (app). Ứng dụng này sẽ đóng vai trò trung gian giữa n8n (hoặc bất kỳ công cụ nào khác) và Facebook Graph API.

1. Tại giao diện quản lý ứng dụng, nhấn vào nút "Tạo ứng dụng" (Create App).
2. Bạn sẽ được hỏi về mục đích sử dụng ứng dụng. Trong hầu hết các trường hợp quản lý Fanpage, hãy chọn loại "Doanh nghiệp" (Business). Lựa chọn này cho phép bạn truy cập và quản lý các tài sản kinh doanh như Trang (Page), Nhóm (Group), Messenger, v.v.
3. Đặt tên cho ứng dụng của bạn. Lưu ý quan trọng: Tránh sử dụng các từ khóa như "Facebook", "Instagram" trong tên ứng dụng vì Facebook không cho phép điều này và sẽ báo lỗi. Ví dụ, thay vì "n8n Facebook API", bạn có thể đặt là "n8n Automation Tool" hoặc một tên tương tự không chứa thương hiệu của Facebook.
4. Chọn tài khoản doanh nghiệp (Business Account) nếu có, hoặc bỏ qua nếu không bắt buộc.
5. Nhấn "Tạo ứng dụng".

Vậy là bạn đã có một ứng dụng sẵn sàng để cấu hình và kết nối.

Bước 2: Chìa khóa vạn năng - Lấy Access Token và các quyền (Permissions) cần thiết

Access Token giống như một chiếc chìa khóa cấp quyền cho ứng dụng của bạn thực hiện các hành động cụ thể trên Facebook.

1. Khám Phá Graph API Explorer

Facebook cung cấp một công cụ tuyệt vời tên là Graph API Explorer (Công cụ khám phá Graph API) để bạn thử nghiệm các lệnh API và quan trọng nhất là lấy Access Token.

• Từ trang quản lý ứng dụng của bạn, tìm đến mục "Công cụ" (Tools) và chọn "Graph API Explorer".

2. Lấy User Access Token và Page Access Token

Ban đầu, bạn sẽ cần lấy User Access Token:

1. Trong Graph API Explorer, ở mục "Ứng dụng Facebook" (Facebook App), chọn ứng dụng bạn vừa tạo.
2. Ở mục "Mã truy cập người dùng" (User or Page Access Token), chọn "Lấy mã truy cập người dùng" (Get User Access Token).
3. Một cửa sổ pop-up sẽ hiện ra, yêu cầu bạn cấp các quyền (permissions) cho ứng dụng. Hãy chọn (hoặc đảm bảo đã chọn) những quyền cơ bản ban đầu.
4. Tiếp theo, Facebook sẽ hỏi bạn muốn cấp quyền truy cập cho Trang (Page) nào. Hãy chọn Trang Fanpage mà bạn muốn tự động hóa.
5. Sau khi cấp quyền, bạn sẽ nhận được một User Access Token.

Tuy nhiên, để thao tác với Fanpage (đăng bài, lấy comment...), chúng ta cần Page Access Token:

1. Sau khi có User Access Token, bạn sẽ thấy một danh sách các Trang mà tài khoản của bạn quản lý (nếu User Token có quyền pages_show_list).
2. Chọn Fanpage bạn muốn làm việc từ danh sách thả xuống bên cạnh mục "Mã truy cập người dùng". Thao tác này sẽ chuyển đổi User Access Token thành Page Access Token tương ứng với Trang đó.
3. ID hiển thị lúc này sẽ là Page ID, khác với User ID của bạn. Đây là thông tin rất quan trọng.

3. Hiểu Về Các Quyền (Permissions)

Mỗi hành động bạn muốn thực hiện qua API đều cần một quyền (permission) tương ứng. Ví dụ:

• pages_show_list: Cho phép liệt kê các trang bạn quản lý.
• pages_read_engagement: Cho phép đọc nội dung và tương tác trên trang (ví dụ: lấy bình luận).
• pages_manage_posts: Cho phép tạo, chỉnh sửa, xóa bài viết trên trang.
• public_profile: Quyền truy cập thông tin công khai cơ bản.
• email: Quyền truy cập địa chỉ email.

Khi lấy token hoặc muốn thêm chức năng mới, bạn cần đảm bảo đã yêu cầu và được cấp đủ các quyền này. Trong Graph API Explorer, bạn có thể tìm kiếm và thêm các quyền trong mục "Quyền" (Permissions). Sau khi thêm quyền mới, bạn cần nhấn "Tạo mã truy cập" (Generate Access Token) một lần nữa để token mới chứa các quyền vừa cập nhật.

Mẹo nhỏ: Khi tìm hiểu về các quyền, hãy chuyển ngôn ngữ của Facebook Developer Docs sang tiếng Anh. Tài liệu tiếng Anh thường đầy đủ và chính xác hơn, giúp bạn hiểu rõ ý nghĩa của từng permission.

4. Gia Hạn Access Token (Short-lived vs Long-lived Token)

Access Token bạn nhận được ban đầu từ Graph API Explorer thường là short-lived token (mã truy cập ngắn hạn), có hiệu lực trong khoảng 1-2 giờ. Để tự động hóa lâu dài, bạn cần long-lived token (mã truy cập dài hạn).

1. Sao chép short-lived Page Access Token bạn vừa có.
2. Đi đến công cụ "Trình gỡ lỗi mã truy cập" (Access Token Debugger) - bạn có thể tìm thấy nó trong mục "Công cụ" hoặc tìm kiếm trực tiếp.
3. Dán token của bạn vào ô "Mã truy cập" và nhấn "Gỡ lỗi" (Debug).
4. Bạn sẽ thấy thông tin chi tiết về token, bao gồm thời gian hết hạn.
5. Ở phía dưới, bạn sẽ thấy nút "Gia hạn mã truy cập" (Extend Access Token). Nhấn vào đó.
6. Facebook sẽ yêu cầu bạn nhập lại mật khẩu. Sau khi xác nhận, bạn sẽ nhận được một long-lived token, thường có hiệu lực khoảng 60 ngày (2 tháng).
7. Hãy lưu trữ cẩn thận long-lived token này, vì đây sẽ là "chìa khóa" bạn dùng trong n8n.

Bước 3: Thực Hành - Tự Động Đăng Bài Lên Fanpage Bằng Graph API

Giờ chúng ta sẽ thử nghiệm việc đăng bài tự động trực tiếp từ Graph API Explorer.

1. Endpoint và Cấu Trúc Request

Để đăng một bài viết lên feed của Fanpage, chúng ta sử dụng endpoint:
/{page_id}/feed

• Thay {page_id} bằng ID của Fanpage bạn (ID này bạn có được khi chuyển sang Page Access Token).
• Phương thức (Method): POST.
• Phần thân yêu cầu (Request Body) sẽ ở định dạng JSON, chứa nội dung bài viết. Ví dụ:

  {
    "message": "Xin chào mọi người từ Excel Talk! Đây là bài đăng tự động."
  }
  

2. Đăng Bài Thử Nghiệm

1. Trong Graph API Explorer:
   • Đảm bảo bạn đang sử dụng Page Access Token của Fanpage muốn đăng.
   • Chọn phương thức POST.
   • Nhập endpoint /{page_id}/feed (thay {page_id} bằng ID thực tế).
   • Trong tab "JSON", nhập nội dung JSON như ví dụ trên.
   • Nhấn "Gửi" (Submit).
2. Nếu thành công, bạn sẽ nhận được phản hồi chứa ID của bài viết vừa đăng. Hãy kiểm tra Fanpage của bạn để xem bài viết đã xuất hiện chưa.

3. Lấy Bình Luận (Comments)

Tương tự, để lấy các bình luận của một bài viết cụ thể:

• Endpoint: /{post_id}/comments
  • Thay {post_id} bằng ID của bài viết bạn muốn lấy bình luận.
• Phương thức (Method): GET.
• Bạn không cần truyền body cho request này.
• Nhấn "Gửi" (Submit), bạn sẽ nhận được danh sách các bình luận dưới dạng JSON.

Bước 4: Tích Hợp Với n8n Để Tự Động Hóa Hoàn Toàn

n8n là một công cụ tự động hóa quy trình làm việc mã nguồn mở, rất mạnh mẽ và linh hoạt. Chúng ta có thể dùng n8n để "gọi" các API của Facebook một cách tự động theo lịch trình hoặc dựa trên các trigger khác.

1. Sử Dụng Node HTTP Request Trong n8n

Đây là cách tiếp cận linh hoạt nhất, cho phép bạn tương tác với bất kỳ API nào, bao gồm cả Facebook Graph API.

1. Tạo một workflow mới trong n8n.
2. Thêm một node "HTTP Request".
3. Cấu hình node:
   • Authentication: Chọn "Header Auth".
     • Name: Authorization
     • Value: Bearer YOUR_LONG_LIVED_PAGE_ACCESS_TOKEN (Thay YOUR_LONG_LIVED_PAGE_ACCESS_TOKEN bằng mã token dài hạn bạn đã lưu).
     • Hoặc, bạn có thể truyền access_token như một tham số trong URL hoặc trong body, nhưng Header Auth thường được khuyến nghị.
   • Method: POST (để đăng bài) hoặc GET (để lấy thông tin).
   • URL: https://graph.facebook.com/vXX.X/{page_id}/feed
     • vXX.X là phiên bản API (ví dụ: v19.0). Bạn có thể thấy phiên bản hiện tại trong Graph API Explorer.
     • Thay {page_id} bằng ID Fanpage của bạn.
   • Body Content Type: JSON.
   • JSON Parameters (hoặc Body Parameters):
     • Nhấn "Add Parameter".
     • Key: message
     • Value: Nội dung bài viết bạn muốn đăng (có thể là giá trị cố định hoặc lấy từ node trước đó trong workflow).
   • Nhấn "Execute Node" để kiểm tra.

2. Sử Dụng Node "Facebook Graph API" Tích Hợp Sẵn

n8n cũng cung cấp một node chuyên dụng cho Facebook Graph API, giúp đơn giản hóa một số thao tác.

1. Thêm node "Facebook Graph API" vào workflow.
2. Credentials:
   • Nhấn "Create New".
   • Đặt tên cho credential (ví dụ: "FB Page Token").
   • Dán Long-lived Page Access Token của bạn vào ô "Access Token".
   • Lưu lại.
3. Resource: Chọn "Page".
4. Operation:
   • Để đăng bài: Chọn "Post Feed".
     • Page ID: Nhập ID Fanpage của bạn.
     • Message: Nhập nội dung bài viết.
   • Để lấy bình luận: Chọn "Post", sau đó chọn Operation "Get Comments".
     • Post ID: Nhập ID của bài viết.
5. Cấu hình các trường cần thiết khác (nếu có).
6. Nhấn "Execute Node" để kiểm tra.

Ví dụ Workflow tự động đăng bài và lấy comment:

• Node 1: Cron (Lên lịch): Thiết lập thời gian tự động chạy workflow (ví dụ: mỗi ngày lúc 9 giờ sáng).
• Node 2: Function (Tạo nội dung): Viết một đoạn code JavaScript nhỏ để tạo nội dung bài đăng động (ví dụ: lấy tin tức từ RSS feed, hoặc một câu nói hay ngẫu nhiên).
• Node 3: Facebook Graph API (Đăng bài): Sử dụng node này để đăng nội dung từ Node 2 lên Fanpage. Output của node này sẽ chứa ID của bài viết vừa đăng.
• Node 4: Wait (Chờ): Chờ một khoảng thời gian nhất định (ví dụ: 1 giờ) để người dùng có thời gian bình luận.
• Node 5: Facebook Graph API (Lấy comment): Sử dụng ID bài viết từ Node 3 để lấy tất cả bình luận.
• Node 6: Spreadsheet File / Database (Lưu trữ): Lưu các bình luận vào Google Sheets hoặc một cơ sở dữ liệu để phân tích sau.

Bước 5: Hiểu Sâu Hơn Về Facebook App Mode và Access Token

Phần này sẽ giải đáp một số thắc mắc thường gặp và giúp bạn hiểu rõ hơn về cơ chế hoạt động phía sau.

1. App Mode: Development (Phát triển) vs Live (Hoạt động)

Khi bạn tạo một ứng dụng Facebook, mặc định nó sẽ ở chế độ Development (Phát triển). Nhiều hướng dẫn trên mạng khuyên bạn nên chuyển ứng dụng sang chế độ Live (Hoạt động) và yêu cầu cung cấp URL Chính sách Quyền riêng tư (Privacy Policy URL).

• Khi nào cần chuyển sang Live Mode?
  • Khi bạn muốn ứng dụng của mình được người dùng khác (không có vai trò admin, developer, tester trong ứng dụng của bạn) sử dụng.
  • Khi ứng dụng của bạn cần các quyền (permissions) yêu cầu App Review (xem xét ứng dụng).
• Đối với mục đích cá nhân hoặc tự động hóa nội bộ cho Fanpage của bạn:
  • Bạn KHÔNG NHẤT THIẾT phải chuyển sang Live Mode.
  • Ứng dụng ở Development Mode vẫn cho phép bạn (với tư cách là admin/developer của app) lấy được Long-lived Access Token và thực hiện các thao tác trên Fanpage mà bạn quản lý (miễn là token có đủ quyền).
  • Việc này giúp bạn tiết kiệm thời gian không phải tạo Privacy Policy hay chờ đợi quá trình App Review nếu không thực sự cần thiết.

Facebook cho biết: "Apps in development mode can only access data for users who have a role on the app (admin, developer, or tester). They cannot manage accesses that they do not have or do not own." Điều này có nghĩa là nếu bạn là người duy nhất sử dụng app này để quản lý page của chính mình, Development Mode là đủ.

2. App Review (Xem Xét Ứng Dụng)

Một số quyền truy cập dữ liệu nhạy cảm (ví dụ: truy cập dữ liệu người dùng không phải bạn bè, đăng bài lên trang cá nhân của người dùng khác) yêu cầu Facebook phải xem xét và phê duyệt ứng dụng của bạn (App Review).

• Hầu hết các quyền cơ bản để quản lý Fanpage (như pages_manage_posts, pages_read_engagement) không yêu cầu App Review khi bạn sử dụng Page Access Token của chính trang đó. Đây là lý do tại sao việc tự động đăng bài lên Fanpage thường dễ dàng hơn nhiều so với đăng lên trang cá nhân (profile).
• Nếu bạn cần các quyền yêu cầu App Review, bạn sẽ phải chuyển app sang Live Mode và cung cấp đầy đủ thông tin theo yêu cầu của Facebook.

3. Cơ Chế Hoạt Động Của Access Token (Luồng OAuth 2.0)

Hiểu cách Access Token được tạo ra sẽ giúp bạn tự tin hơn khi làm việc với các API:

1. Ứng Dụng (App): Bạn tạo một App trên Facebook Developer Portal. App này có một App ID (Client ID) và một App Secret (Client Secret - giống như mật khẩu của ứng dụng).
2. Ủy Quyền (Authorization): Khi bạn (người dùng) muốn cấp quyền cho App, bạn sẽ được chuyển đến một trang đăng nhập của Facebook. Sau khi đăng nhập và đồng ý cấp quyền (ví dụ: quản lý trang, đọc bài viết), Facebook sẽ chuyển hướng bạn trở lại ứng dụng (hoặc một URL định trước) kèm theo một Authorization Code.
3. Trao Đổi Lấy Token:
   • App của bạn (hoặc n8n, Graph API Explorer thay mặt bạn) sẽ dùng Authorization Code này, cùng với App ID và App Secret, để gửi một yêu cầu đến máy chủ của Facebook.
   • Facebook xác minh thông tin và trả về một Short-lived Access Token.
4. Lấy Long-lived Token:
   • App tiếp tục dùng Short-lived Access Token này để yêu cầu một Long-lived Access Token.
5. Sử Dụng Token: Long-lived Access Token này sau đó được sử dụng trong mỗi lệnh API gửi đến Facebook để xác thực rằng App của bạn có quyền thực hiện hành động đó.

Graph API Explorer và node Facebook tích hợp trong n8n (phiên bản Cloud) đã đơn giản hóa rất nhiều bước trong quy trình này cho bạn. Khi bạn tự host n8n hoặc dùng node HTTP Request, bạn sẽ cần tự quản lý việc lấy và gia hạn token.

Tại sao n8n Cloud dễ dàng hơn?
Khi bạn kết nối Facebook trên n8n Cloud, bạn thường chỉ cần nhấp vào nút "Sign in with Facebook". Đó là vì n8n đã có một ứng dụng Facebook "chính thức" (đã được review, ở chế độ Production/Live). Ứng dụng này của n8n sẽ xử lý toàn bộ quy trình OAuth 2.0 phức tạp phía sau, giúp bạn lấy token một cách nhanh chóng. Khi bạn tự host và tự tạo app, bạn đang tự mình thực hiện các bước này.

Kết Luận

Việc kết nối Facebook Graph API với n8n mở ra vô vàn khả năng tự động hóa cho Fanpage của bạn, từ việc lên lịch đăng bài, thu thập và phân tích tương tác, đến việc xây dựng các chatbot đơn giản. Mặc dù ban đầu có thể có một chút phức tạp với việc tạo app, lấy token và hiểu về các quyền, nhưng một khi bạn đã nắm vững các bước cơ bản được trình bày trong bài viết này, bạn sẽ thấy việc tự động hóa trở nên dễ dàng và mạnh mẽ hơn bao giờ hết.

Đừng ngần ngại thử nghiệm, đọc thêm tài liệu chính thức từ Facebook Developer và khám phá các tính năng của n8n. Chúc bạn thành công trên hành trình tự động hóa Fanpage của mình!