# REST API untuk CRM dengan webhook bertanda tangan | AiCrm

> CRM dengan REST API publik: buat dan lihat kontak dengan header X-Api-Key, hingga 20 kunci per integrasi, dan webhook keluar bertanda tangan HMAC-SHA256. Tanpa duplikat.

- **Sumber (source):** https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/f/api-rest-crm-webhook-bertanda-tangan
- **Platform (platform):** AIstoHire
- **Bahasa (language):** id

## Ringkasan

- REST API publik dengan beberapa API key dan webhook bertanda tangan
- Daftarkan pelanggan dari situs web, formulir, atau backend Anda dengan satu panggilan HTTP, dan terima setiap perubahan di server Anda dengan tanda tangan HMAC-SHA256.
- Pendaftaran kontak dengan satu panggilan
- Tanpa duplikat sejak desain
- Hingga 20 kunci bernama

## REST API publik dengan beberapa API key dan webhook bertanda tangan

AiCrm, aplikasi CRM dari AIsToHire, menyediakan REST API publik atas kontak Anda sendiri. Dengan sebuah kunci di header `X-Api-Key` Anda dapat membuat, mendaftar, melihat, memperbarui, dan menghapus kontak, serta menambahkan aktivitas ke kontak mana pun, dari formulir situs web Anda, chatbot, Zap, skrip Python, atau backend Anda sendiri. Responsnya JSON dengan bentuk `{ success, data }`, dan batasnya 100 permintaan per menit per kunci.

Pendaftaran via API tidak menggandakan: jika email yang Anda kirim sudah ada di database Anda, AiCrm memperbarui kartu yang sudah Anda miliki (melengkapi telepon, nama, atau perusahaan yang kurang, menggabungkan tag) dan mencatat pengiriman baru di timeline-nya, mengembalikan HTTP 200; jika baru, ia membuatnya dan mengembalikan 201. Setiap kontak yang masuk melalui API diberi tag otomatis `api-lead`, mempertahankan tag yang Anda kirim, dan menyimpan `subId` asal, ditambah negara, IP, dan browser tempat ia datang.

Anda dapat memiliki hingga 20 API key dengan nama sendiri, selain kunci internal aplikasi. Dengan begitu Anda memberi kunci berbeda untuk setiap integrasi —situs web, formulir kampanye Mei, pekerja magang, vendor— dan mencabutnya sendiri ketika integrasi itu berakhir, tanpa menyentuh yang lain. Nilai lengkap sebuah kunci hanya ditampilkan satu kali, saat dibuat; setelah itu hanya terlihat tersamar di daftar.

Ke arah sebaliknya, webhook memberi tahu sistem Anda. Anda mengonfigurasi hingga 10 tujuan, memilih peristiwa mana yang dilanggan masing-masing (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) dan AiCrm melakukan POST ke URL Anda dengan header `X-AiCrm-Event` dan `X-AiCrm-Signature: sha256=…`, tanda tangan HMAC-SHA256 dari isi dengan rahasia webhook itu, agar Anda memverifikasi bahwa pengirimannya sah. Saat URL disimpan, pelindung anti-SSRF menolak localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0, dan domain `.local` serta `.internal`.

## Yang termasuk

- **Pendaftaran kontak dengan satu panggilan** — satu POST ke `/api/apps/public/crm/customers` dengan email dan tag yang Anda inginkan, dan lead sudah ada di CRM Anda dan terklasifikasi.
- **Tanpa duplikat sejak desain** — jika email sudah ada, kartu diperbarui dan pengiriman baru dicatat di timeline-nya alih-alih membuat kartu kedua.
- **Hingga 20 kunci bernama** — satu per integrasi, dapat dicabut terpisah. Jika satu kunci bocor, Anda menghapus kunci itu saja dan tidak ada yang lain berhenti berfungsi.
- **Webhook bertanda tangan HMAC-SHA256** — Anda memverifikasi header `X-AiCrm-Signature` dengan rahasia Anda dan tahu bahwa pemberitahuan datang dari CRM Anda, bukan dari pihak ketiga.
- **Pelindung anti-SSRF disertakan** — aplikasi menolak mengirim webhook ke localhost atau rentang jaringan privat, sehingga CRM Anda tidak dapat dipakai untuk menyelidiki jaringan internal.
- **CRUD lengkap, bukan hanya pendaftaran** — daftar dengan paginasi dan filter (pencarian, status, tag, negara), lihat satu kontak beserta aktivitasnya, perbarui, hapus, dan catat aktivitas padanya.
- **Asal terlacak otomatis** — setiap pendaftaran via API menyimpan `subId` yang Anda kirim ditambah negara, IP, dan browser, dan diberi tag `api-lead` untuk disaring nanti di aplikasi.
- **Uji coba tanpa menebak** — aplikasi menyertakan dokumentasi endpoint dengan contoh `curl` yang dapat disalin dan tombol untuk mengirim pengiriman uji ke setiap webhook, dengan status dan waktu percobaan terakhir.

## Pertanyaan umum

### Bagaimana cara membuat kontak di CRM dari situs web saya?

Anda melakukan POST ke `/api/apps/public/crm/customers` dengan header `X-Api-Key` dan JSON dengan setidaknya email atau telepon. Anda juga dapat mengirim nama, telepon, perusahaan, negara, status, catatan, tag, dan `subId` untuk mengidentifikasi kampanye atau formulir asal. AiCrm mengembalikan 201 jika membuatnya dan 200 jika kontak itu sudah ada.

### Apa yang terjadi jika email yang sama masuk dua kali lewat API?

Tidak digandakan. AiCrm mencari email (atau telepon, jika Anda tidak mengirim email) dan, jika menemukannya, memperbarui kartu yang ada dengan mengisi kolom yang kosong, menggabungkan tag baru dengan yang sudah ada, dan mencatat pengiriman baru di timeline aktivitasnya. Responsnya menyatakan bahwa kontak sudah ada dan mengembalikan id-nya.

### Berapa API key yang bisa saya miliki dan bisakah saya mencabut satu saja?

Anda dapat membuat hingga 20 kunci dengan nama sendiri, selain kunci internal aplikasi, yang tidak dapat dihapus. Setiap kunci dihapus secara independen, sehingga Anda dapat memberi kunci berbeda untuk setiap integrasi dan mencabutnya tanpa memengaruhi yang lain. Nilai lengkapnya hanya ditampilkan saat kunci dibuat; setelah itu muncul tersamar di daftar. Semua kunci berbagi batas 100 permintaan per menit per kunci.

### Bagaimana saya memverifikasi bahwa webhook benar-benar berasal dari CRM saya?

Setiap pengiriman membawa header `X-AiCrm-Signature: sha256=<tanda tangan>`, yaitu HMAC-SHA256 dari isi permintaan yang persis menggunakan rahasia yang ditampilkan aplikasi saat Anda membuat webhook. Hitung HMAC itu di server Anda atas isi yang diterima dan bandingkan. Selain itu ada juga header `X-AiCrm-Event` dengan nama peristiwa: `customer.created`, `customer.updated`, `customer.deleted`, atau `activity.created`.

### Apa yang terjadi jika endpoint webhook saya mati?

Pengirimannya bersifat best-effort: AiCrm menunggu hingga 5 detik dan, jika gagal, mencoba lagi setelah satu setengah detik. Tidak ada antrean percobaan ulang yang persisten, sehingga server Anda yang mati lama dapat membuat Anda kehilangan pemberitahuan; dalam kasus itu, rekonsiliasi dengan GET ke `/api/apps/public/crm/customers`. Aplikasi menampilkan status dan waktu percobaan terakhir setiap webhook, dan Anda dapat memicu pengiriman uji kapan saja.

- [AiCrm — CRM ringan dengan API untuk mendaftarkan pelanggan dari sistem mana pun](https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109)

## Tentang platform

**AiCrm — CRM ringan dengan API untuk mendaftarkan pelanggan dari sistem mana pun** — aplikasi dari AIstoHire. Tersedia di: https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/f/api-rest-crm-webhook-bertanda-tangan

### Bahasa lainnya

- `es`: https://aistohire.com/es/aicrm-crm-ligero-con-api-109/f/api-rest-crm-webhooks-firmados
- `en`: https://aistohire.com/aicrm-lightweight-crm-with-api-109/f/api-rest-crm-signed-webhooks
- `fr`: https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/f/api-rest-crm-webhooks-signes
- `it`: https://aistohire.com/it/aicrm-crm-leggero-con-api-109/f/api-rest-crm-webhook-firmati
- `pt`: https://aistohire.com/pt/aicrm-crm-leve-com-api-109/f/api-rest-crm-webhooks-assinados
- `de`: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/api-rest-crm-signierte-webhooks
- `bg`: https://aistohire.com/bg/aicrm-lesen-crm-s-api-za-upravlenie-na-klienti-i-liydove-109/f/rest-api-crm-podpisani-uebhukove
- `ja`: https://aistohire.com/ja/aicrm-lightweight-crm-with-api-109/f/crm-rest-api-signed-webhooks
- `nl`: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/rest-api-crm-ondertekende-webhooks
- `ko`: https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/f/crm-rest-api-seomyeong-webhook
- `sv`: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/rest-api-crm-signerade-webhooks
- `da`: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/rest-api-crm-signerede-webhooks
- `ar`: https://aistohire.com/ar/aicrm-nzam-crm-bsit-ma-api-lidara-alamla-walamla-almhtmlin-109/f/crm-rest-api-webhooks
- `no`: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/rest-api-crm-signerte-webhooks
- `fi`: https://aistohire.com/fi/aicrm-yksinkertainen-crm-rajapinnalla-asiakkaille-ja-liideille-109/f/crm-rest-api-allekirjoitetut-webhookit
- `zh`: https://aistohire.com/zh/ai-crm-rest-api-webhooks-109/f/crm-rest-api-webhook
- `pl`: https://aistohire.com/pl/aicrm-prosty-crm-z-api-do-zarzadzania-klientami-i-leadami-109/f/api-rest-crm-podpisane-webhooki
- `he`: https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/f/api-rest-crm-webhooks-chatumim
- `cs`: https://aistohire.com/cs/aicrm-jednoduche-crm-s-api-pro-spravu-klientu-a-leadu-109/f/rest-api-crm-podepsane-webhooky
