Dashboard bekerja baik untuk satu tugas berisi 20 akun. Dashboard kurang sesuai ketika lingkungan staging membutuhkan inbox baru pada setiap deployment atau produk membuat akun selama onboarding klien. API tersedia untuk kebutuhan tersebut.
Paket tahunan menyediakan akses REST untuk mengirim tugas, memeriksa status, dan membawa hasil ke sistem Anda. Pipeline CI, panel admin, dan alat internal merupakan penggunaan umum. Jangan tulis kredensial hasil ke log; pindahkan ke penyimpanan yang disetujui.
Yang umum diotomatiskan
- CI/CD: menyiapkan 10 akun Gmail pengujian ketika branch staging diterapkan
- Onboarding: menyediakan inbox saat organisasi bergabung dengan produk
- QA: memberikan akun baru untuk pengujian Playwright atau Selenium
- Operasional internal: sebuah tombol untuk membuat 50 akun Yahoo bagi proyek tertentu
Alur integrasi dasar
- 1Berlangganan paket tahunan dan buat kunci di Dashboard → API
- 2Kirim `POST /tasks` dengan penyedia (`gmail`, `yahoo`, atau `outlook`), jumlah, dan opsi nama
- 3Segera simpan `task_id` yang dikembalikan
- 4Periksa `GET /tasks/{id}` setiap 30 hingga 60 detik hingga status `completed` atau `failed`
- 5Ambil daftar melalui endpoint detail tugas dan sinkronkan dengan database
Hasil tidak tersedia seketika
Jangan blokir antarmuka sambil menunggu. Tugas berisi 50 akun Gmail dapat membutuhkan 30 hingga 90 menit. Kembalikan ID tugas dan beri tahu pengguna ketika selesai melalui webhook, email, atau pemeriksaan backend.
Keamanan: persyaratan wajib
| Aturan | Alasan |
|---|---|
| Kunci hanya di backend | Kunci dalam frontend dapat disalahgunakan |
| Satu kunci per lingkungan | Kebocoran staging tidak membahayakan produksi |
| Rotasi kunci secara berkala | Membatasi dampak kebocoran |
| Enkripsi kata sandi tersimpan | Kata sandi merupakan data rahasia |
| Catat ID tugas, bukan kata sandi | Memungkinkan debugging tanpa membocorkan kredensial |
Ketika terjadi masalah
- Keberhasilan dapat bersifat sebagian. Periksa status setiap akun dan coba kembali kegagalan dalam tugas baru.
- Patuhi batas penggunaan. Tingkatkan jeda dari 30 menjadi 60 lalu 120 detik.
- Jika tugas tetap `processing` lebih dari tiga jam, catat dan buat peringatan. Jangan menganggapnya gagal lalu membuat duplikat.
- Simpan `task_id` sebelum memeriksa. Jika skrip berhenti, lanjutkan tugas yang sama daripada memulai tugas lain.
Dokumentasi API
Referensi endpoint, format permintaan dan respons, serta header autentikasi tersedia di dashboard pada Akses API setelah berlangganan paket tahunan.
Pembuatan hanyalah tahap pertama otomatisasi. Gunakan panduan integrasi alat outreach untuk penyerahan ke platform pengiriman dan alur penyediaan akun untuk persetujuan, penanggung jawab, penyimpanan, serta penutupan.