API Đám mây

Nền tảng WhatsApp Business > API Đám mây > Hướng dẫn

Chuyển từ API Đám mây sang API Tại chỗ

Chúng tôi sẽ ngừng cung cấp API Tại chỗ. Hãy tham khảo tài liệu về việc Ngừng cung cấp API Tại chỗ để biết chi tiết, đồng thời tìm hiểu cách chuyển sang API Đám mây thế hệ tiếp theo của chúng tôi.

Tài liệu này giải thích cách chuyển số điện thoại của doanh nghiệp từ API Đám mây sang API Tại chỗ. Để chuyển từ API Tại chỗ sang API Đám mây, hãy xem bài viết Chuyển từ API Tại chỗ sang API Đám mây.

Lưu ý rằng quy trình chuyển số điện thoại của doanh nghiệp giữa các API không giống với quy trình chuyển số điện thoại giữa các Tài khoản WhatsApp Business (WABA).

Quy trình chuyển KHÔNG ảnh hưởng đến:

  • tên hiển thị, trạng thái xác minh hoặc xếp hạng chất lượng của số điện thoại của doanh nghiệp
  • các mẫu mà số điện thoại của doanh nghiệp sử dụng hoặc trạng thái của chúng
  • WABA sở hữu, trạng thái Tài khoản kinh doanh chính thức hoặc giới hạn nhắn tin của tài khoản đó

Tuy nhiên, để hỗ trợ quá trình chuyển, bạn phải nắm rõ điểm khác biệt giữa các API và có hành động thích hợp để giải quyết trước khi thực hiện các bước chuyển như đã nêu trong tài liệu này.

Cách làm tốt nhất

Sau khi đảm bảo rằng ứng dụng đó có thể xử lý tất cả những điểm khác biệt về API, trước tiên, bạn nên chuyển số điện thoại của doanh nghiệp có số lượng hoạt động nhỏ và xác minh rằng tất cả chức năng mà bạn định cung cấp với API Tại chỗ đều hoạt động chính xác. Sau khi xác minh rằng mọi thứ đều hoạt động bình thường, hãy chuyển các số điện thoại khác.

Bạn cũng nên chuyển khi lưu lượng truy cập vào phương thức triển khai API Tại chỗ ở mức thấp.

Điểm khác biệt giữa các API

Hãy đảm bảo ứng dụng của bạn có thể xử lý những điểm khác biệt này trước khi bắt đầu quá trình chuyển.

Webhooks

Phần tải dữ liệu webhook của API Đám mây và API Quản lý doanh nghiệp có cấu trúc khác với phần tải dữ liệu của API Tại chỗ. Bạn nên tạo điểm cuối webhook mới chỉ có khả năng xử lý webhook API Tại chỗ.

Hãy tham khảo những tài liệu dưới đây để nắm rõ điểm khác biệt giữa các phần tải dữ liệu:

Sau khi quá trình chuyển sang API Tại chỗ hoàn tất, webhook API Đám mây của số điện thoại này của doanh nghiệp sẽ không được phân phối nữa và quá trình phân phối webhook API Tại chỗ sẽ bắt đầu.

File phương tiện

Do không thể sử dụng ID file phương tiện của bất kỳ file phương tiện nào được tải lên API Đám mây khi gửi tin nhắn bằng API Tại chỗ, bạn phải tải lại file phương tiện lên bằng API Tại chỗ để tạo ID file phương tiện mới hoặc sử dụng URL file phương tiện nếu file phương tiện đó được lưu trữ trên máy chủ công khai. Hãy xem bài viết Gửi tin nhắn có chứa file phương tiện.

Mã lỗi

Mã lỗi của API Đám mây và API Quản lý doanh nghiệp khác với mã lỗi của API Tại chỗ. Hãy xem tài liệu dưới đây:

Tin nhắn nhấn để nói

API Tại chỗ xác định tin nhắn nhấn để nói (PTT) trong webhook bằng cách đặt messages.type thành voice, nhưng API Đám mây xác định tin nhắn PTT bằng cách đặt messages.audio.voice thành true.

Thời gian dừng chạy

Thời gian dừng chạy bắt đầu ngay khi bạn thực hiện bước đăng ký (bước 3) và sẽ chỉ kéo dài vài giây. Trong thời gian này, hệ thống sẽ tự động hủy bỏ tin nhắn mà người dùng WhatsApp gửi đến số điện thoại đó.

Bạn nên đặt lịch chuyển trong thời gian số điện thoại có ít hoạt động để giảm thiểu bất kỳ tác động nào do thời gian dừng chạy gây ra.

Bước 1: Tích hợp API Tại chỗ

Vì bạn đang chuyển số điện thoại doanh nghiệp sang API Tại chỗ, nên hãy đảm bảo rằng ứng dụng của bạn có thể dùng thành công ứng dụng API Tại chỗ và rằng Tài khoản WhatsApp Business liên kết với số điện thoại doanh nghiệp đó đã đặt cấu hình webhooks đúng cách.

Bước 2: Chuẩn bị chuyển

Bạn nên dừng gửi tin nhắn trong khi hoàn tất quá trình chuyển.

Ứng dụng Tại chỗ của API WhatsApp Business có một số yêu cầu về mạng để kết nối với máy chủ WhatsApp. Để đảm bảo bạn đã sẵn sàng, hãy xem bài viết Thiết lập và gỡ lỗi mạng.

Bước 3: Đăng ký ứng dụng API

Đăng ký số điện thoại doanh nghiệp trên ứng dụng API Tại chỗ của bạn. Để làm việc đó, hãy gọi điểm cuối /account:

POST /v1/account

{
    "cc": "COUNTRY_CODE",
    "phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
    "method": "sms" or "voice",
    "cert": "VERIFIED_NAME_CERT_IN_BASE64",
    "pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}

Tùy thuộc vào phản hồi nhận được, bạn sẽ biết mình đã hoàn tất quy trình đăng ký hay cần phải thực hiện thêm bước khác. Nếu thành công, bạn sẽ nhận được một trong các mã trạng thái HTTP dưới đây. Hãy làm theo hướng dẫn phù hợp với phản hồi mà bạn nhận được:

  • 201 Created - Tài khoản này đã tồn tại. Bạn đã đăng ký rồi nên không phải làm gì nữa.
  • 202 Accepted - Tài khoản này không tồn tại. Tùy thuộc vào phương thức bạn đã chọn trong yêu cầu, hãy kiểm tra SMS hoặc nghe cuộc gọi thoại để lấy mã đăng ký. Phản hồi này sẽ có phần tải dữ liệu được trả về chứa vname được giải mã từ thông số cert để bạn xác nhận rằng bạn đang đặt đúng tên hiển thị. Nếu đúng, hãy chọn Hoàn tất đăng ký tài khoản để hoàn tất đăng ký.

Xem tất cả trường có sẵn cho điểm cuối này ở đây.

Sau khi quá trình đăng ký hoàn tất, ứng dụng API Tại chỗ sẽ là ứng dụng nhận tin nhắn.

Bước 4: Đặt số đoạn

Sau khi ứng dụng của bạn được đăng ký, bạn có thể đặt số đoạn, nếu cần.

Bước 5: Bắt đầu gửi tin nhắn

Bạn có thể gửi tin nhắn cho khách hàng của mình rồi. Hãy xem hướng dẫn trong bài viết Gửi tin nhắn.