react-native-ecentrix-voip/README.md

package ecentrix8 telephony agent, call center, telemarketing, omnichannel, collection system

# 📞 react-native-ecentrix-voip

Package untuk integrasi **VoIP (Voice over IP)** dalam aplikasi React Native, dikembangkan oleh Ecentrix8. Cocok untuk digunakan dalam sistem **call center**, **telemarketing**, **omnichannel**, dan **collection system**.

[![npm version](https://img.shields.io/npm/v/react-native-ecentrix-voip)](https://www.npmjs.com/package/react-native-ecentrix-voip)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

---


## ✨ Fitur Utama

* 📱 Integrasi VoIP dengan React Native
* 🔔 Mendukung notifikasi panggilan masuk
* 📡 Kompatibel dengan sistem omnichannel call center
* 🧩 Dapat diintegrasikan dengan sistem collection & telemarketing

---


## 📦 Instalasi

```bash
npm install react-native-ecentrix-voip
```

atau

```bash
yarn add react-native-ecentrix-voip
```

---


## 🚀 Penggunaan Dasar

```js
import eVoip from 'react-native-ecentrix-voip';

// Inisialisasi
eVoip.register(${username}, ${access_token}, function(data){})

// Melakukan panggilan
eVoip.call('{JSON_FORMAT}', 'NUMBER');

// Send DTMF
eVoip.sendDTMF(value,function(result){ console.log(result) })

// Ganti audio ke earphone
eVoip.setAudioEarphone((data)=>{ console.log(data)})

// Ganti audio ke speaker
eVoip.setAudioLoudspeaker((data)=>{ console.log(data)})

// Menutup panggilan
eVoip.hangupCall((data)=>{ console.log(data)})

// Mute / Unmute call
eVoip.toogleMuteCall((result)=>{ console.log(result)})
```

---


## 📚 API

### `eVoip.register(${username}, ${access_token}, function(data){})`

| Properti      | Tipe     | Deskripsi                      |
| ----------    | -------- | ------------------------------ |
| `username`    | `string` | UniqueID client                |
| `access_token`| `string` | Receive from api url           |

---


### `eVoip.call('{JSON_FORMAT}', 'NUMBER');`

Melakukan panggilan ke call center.

### `eVoip.hangupCall((data)=>{ console.log(data)})`

Mengakhiri panggilan.

---


## 📡 Event yang Tersedia

Gunakan event listener untuk menangani status dan aktivitas VoIP:

```js
Voip.on('eventName', callback);
```

### Daftar Event Network State:

| Event Name           | Deskripsi                                                      |
| -------------------- | ---------------------------------------------------------------|
| `connected`          | websocket connection to ecentrix server established            |
| `registered`         | success registered to ecentrix server.                         |
| `disconnected`       | connection closed                                              |
| `unregistered`       | unregister connection (timeout or down)                        |
| `registrationFailed` | registration failed (authentication error or server down, etc) |

---


### Daftar Event Call State:

| Event Name           | Deskripsi                                                      |
| -------------------- | ---------------------------------------------------------------|
| `connecting ...`     | calling to ivr system                                          |
| `progress`           | ringing ivr audio prompt                                       |
| `accepted`           | call answered (ivr)                                            |
| `confirmed `         | call confirm - media sould be active (ivr)                     |
| `ended `             | call ended (normal hangup)                                     |
| `failed`             | failed call (busy, no answer, error, etc)                      |

---


## 📄 License

© 2025 [Angga Pratama](mailto:angga@ecentrix.co.id)

---


## 🛠️ Tentang

Bagian dari platform omnichannel **Ecentrix**
Untuk informasi lebih lanjut: [https://www.ecentrix.co.id](https://www.ecentrix.co.id)