1
+ # ⚠️ ⚠️ ⚠️ Deprecated Package ⚠️ ⚠️ ⚠️
2
+
3
+ This package has been renamed, and so this version has been deprecated.
4
+
5
+ Development is continuing under the name [ @sipcentric/pbx-client ] ( https://www.npmjs.com/package/@sipcentric/pbx-client ) , please use that instead.
6
+
7
+ ---
8
+
1
9
# Nimvelo Node.js Client
2
10
3
11
Node.js client for the [ Nimvelo/Sipcentric API] ( https://developer.nimvelo.com/ ) .
4
12
5
-
6
13
## Usage
7
14
8
15
```
9
16
npm install @nimvelo/phone-api-client
10
17
```
11
18
12
19
``` js
13
- const Nimvelo = require (' @nimvelo/phone-api-client' );
20
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
14
21
15
22
// ...
16
23
```
@@ -39,12 +46,12 @@ There are further examples in the `examples/` directory. To try them, just clone
39
46
#### Get all customers a user has access to
40
47
41
48
``` js
42
- const Nimvelo = require (' @nimvelo/phone-api-client' );
49
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
43
50
44
51
(async () => {
45
52
const nimvelo = new Nimvelo ({
46
- username: ' myusername' ,
47
- password: ' mypassword'
53
+ username: " myusername" ,
54
+ password: " mypassword"
48
55
});
49
56
50
57
const customers = await nimvelo .customers .get ();
@@ -55,12 +62,12 @@ const Nimvelo = require('@nimvelo/phone-api-client');
55
62
#### Get a specific customer
56
63
57
64
``` js
58
- const Nimvelo = require (' @nimvelo/phone-api-client' );
65
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
59
66
60
67
(async () => {
61
68
const nimvelo = new Nimvelo ({
62
- username: ' myusername' ,
63
- password: ' mypassword'
69
+ username: " myusername" ,
70
+ password: " mypassword"
64
71
});
65
72
66
73
const customerId = 1234 ;
@@ -73,12 +80,12 @@ const Nimvelo = require('@nimvelo/phone-api-client');
73
80
#### Get a customer's phone book
74
81
75
82
``` js
76
- const Nimvelo = require (' @nimvelo/phone-api-client' );
83
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
77
84
78
85
(async () => {
79
86
const nimvelo = new Nimvelo ({
80
- username: ' myusername' ,
81
- password: ' mypassword'
87
+ username: " myusername" ,
88
+ password: " mypassword"
82
89
});
83
90
84
91
const customerId = 1234 ;
@@ -93,26 +100,24 @@ const Nimvelo = require('@nimvelo/phone-api-client');
93
100
#### Create phone book entry
94
101
95
102
``` js
96
- const Nimvelo = require (' @nimvelo/phone-api-client' );
103
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
97
104
98
105
(async () => {
99
106
const nimvelo = new Nimvelo ({
100
- username: ' myusername' ,
101
- password: ' mypassword'
107
+ username: " myusername" ,
108
+ password: " mypassword"
102
109
});
103
110
104
111
const customerId = 1234 ;
105
112
106
113
const customer = await nimvelo .customers .get (customerId);
107
114
const phonebookentry = {
108
- name: ' Nimvelo' ,
109
- phoneNumber: ' 03301200030' ,
110
-
115
+ name: " Nimvelo" ,
116
+ phoneNumber: " 03301200030" ,
117
+
111
118
};
112
119
113
- const createdEntry = await customer .phonebook
114
- .create (phonebookentry)
115
- .save ();
120
+ const createdEntry = await customer .phonebook .create (phonebookentry).save ();
116
121
117
122
console .log (createdEntry);
118
123
})();
@@ -121,12 +126,12 @@ const Nimvelo = require('@nimvelo/phone-api-client');
121
126
#### Update phone book entry
122
127
123
128
``` js
124
- const Nimvelo = require (' @nimvelo/phone-api-client' );
129
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
125
130
126
131
(async () => {
127
132
const nimvelo = new Nimvelo ({
128
- username: ' myusername' ,
129
- password: ' mypassword'
133
+ username: " myusername" ,
134
+ password: " mypassword"
130
135
});
131
136
132
137
const customerId = 1234 ;
@@ -135,24 +140,23 @@ const Nimvelo = require('@nimvelo/phone-api-client');
135
140
const customer = await nimvelo .customers .get (customerId);
136
141
const phonebookentry = await customer .phonebook .get (phonebookentryId);
137
142
138
- phonebookentry .name = ' Updated name' ;
143
+ phonebookentry .name = " Updated name" ;
139
144
140
145
const savedEntry = await phonebookentry .save ();
141
146
142
147
console .log (savedEntry);
143
148
})();
144
149
```
145
150
146
-
147
151
#### Delete phone book entry
148
152
149
153
``` js
150
- const Nimvelo = require (' @nimvelo/phone-api-client' );
154
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
151
155
152
156
(async () => {
153
157
const nimvelo = new Nimvelo ({
154
- username: ' myusername' ,
155
- password: ' mypassword'
158
+ username: " myusername" ,
159
+ password: " mypassword"
156
160
});
157
161
158
162
const customerId = 1234 ;
@@ -165,58 +169,52 @@ const Nimvelo = require('@nimvelo/phone-api-client');
165
169
})();
166
170
```
167
171
168
-
169
172
#### Subscribe to incoming call events
170
173
171
174
``` js
172
- const Nimvelo = require (' @nimvelo/phone-api-client' );
175
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
173
176
174
177
const nimvelo = new Nimvelo ({
175
- username: ' myusername' ,
176
- password: ' mypassword'
178
+ username: " myusername" ,
179
+ password: " mypassword"
177
180
});
178
181
179
- nimvelo .stream .subscribe (' incomingcall' , function (call ) {
180
-
182
+ nimvelo .stream .subscribe (" incomingcall" , function (call ) {
181
183
console .log (call);
182
-
183
184
});
184
-
185
185
```
186
186
187
-
188
187
#### Monitor presence of an extension
189
188
190
189
``` js
191
- const Nimvelo = require (' @nimvelo/phone-api-client' );
190
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
192
191
193
192
const nimvelo = new Nimvelo ({
194
- username: ' myusername' ,
195
- password: ' mypassword' ,
193
+ username: " myusername" ,
194
+ password: " mypassword"
196
195
});
197
196
198
197
const myCustomerId = 1 ; // Change this to your customer ID
199
198
200
199
// Returns an array of subscriptions
201
200
const subscriptions = await nimvelo .presenceWatcher .subscribe ({
202
201
customerId: myCustomerId,
203
- targets: [' 012345' ], // The extensions you'd like to monitor
202
+ targets: [" 012345" ], // The extensions you'd like to monitor
204
203
onStateChange : (extension , newState ) => {
205
204
console .log (extension); // 012345
206
205
console .log (newState); // AVAILABLE, BUSY, or RINGING
207
- },
206
+ }
208
207
});
209
208
```
210
209
211
-
212
210
#### Monitor presence of all extensions on an account
213
211
214
212
``` js
215
- const Nimvelo = require (' @nimvelo/phone-api-client' );
213
+ const Nimvelo = require (" @nimvelo/phone-api-client" );
216
214
217
215
const nimvelo = new Nimvelo ({
218
- username: ' myusername' ,
219
- password: ' mypassword' ,
216
+ username: " myusername" ,
217
+ password: " mypassword"
220
218
});
221
219
222
220
const subscribeToAll = async () => {
@@ -236,14 +234,13 @@ const subscribeToAll = async () => {
236
234
onStateChange : (extension , newState ) => {
237
235
console .log (extension);
238
236
console .log (newState);
239
- },
237
+ }
240
238
});
241
239
};
242
240
243
241
try {
244
242
subscribeToAll ();
245
243
} catch (err) {
246
- console .error (' Error: ' , err);
244
+ console .error (" Error: " , err);
247
245
}
248
246
```
249
-
0 commit comments