Dora Cell SDK

1npm install @dora-cell/sdk

1import { DoraCell } from "@dora-cell/sdk";
2 
3// ─── Option 1A: Agent Account Login (uses EMAIL) ───
4const sdk = new DoraCell({
5  auth: {
6    type: "login",
7    userType: "agent",
8    email: "agent@example.com",
9    password: "password",
10  },
11  environment: "production",
12  debug: false
13});
14 
15// ─── Option 1B: Admin Account Login (uses USERNAME) ───
16// const sdk = new DoraCell({
17//   auth: {
18//     type: "login",
19//     userType: "admin",
20//     username: "admin_user",
21//     password: "password",
22//   },
23//   environment: "production",
24//   debug: false
25// });
26 
27sdk.on("connection:status", ({ status, extension, error }) => {
28  console.log("Connection:", status, extension, error);
29});
30 
31await sdk.initialize();
32console.log("SDK is ready!");
33 
34// To sign out and clear browser cookies:
35// await sdk.logout();

1// Place an outbound call
2const call = await sdk.call("+2348000000000", {
3  metadata: { customerId: "cus_123" }
4});
5 
6call.mute();
7call.unmute();
8call.hangup();
9 
10// Answer an incoming call
11sdk.on("call:incoming", async (call) => {
12  console.log("Incoming call from:", call.remoteNumber);
13  await sdk.answerCall();
14});
15 
16sdk.on("call:stream", (call, stream) => {
17  const audio = document.querySelector("audio#remote-audio");
18  if (audio) audio.srcObject = stream;
19});

1// Listen for connection status
2sdk.on("connection:status", ({ status, error }) => {
3  console.log("SIP Status changed:", status);
4});
5 
6// Listen for call transitions
7sdk.on("call:connected", (call) => {
8  console.log("Conversation started with:", call.remoteNumber);
9});
10 
11sdk.on("call:ended", (call, reason) => {
12  console.log("Call ended. Reason:", reason);
13});
14 
15sdk.on("call:failed", (call, error) => {
16  console.error("Call failed:", error);
17});

1npm install @dora-cell/sdk @dora-cell/sdk-react
2# or
3pnpm add @dora-cell/sdk @dora-cell/sdk-react

1import { DoraCellProvider } from "@dora-cell/sdk-react";
2import "@dora-cell/sdk-react/styles.css";
3 
4export default function RootLayout({ children }) {
5  return (
6    <DoraCellProvider
7      config={{
8        auth: {
9          type: "login",
10          userType: "agent", // For Admin accounts, use userType: "admin" and replace 'email' with 'username'
11          email: "agent@example.com",
12          password: "password",
13        },
14        environment: "production"
15      }}
16      autoInitialize={true}
17    >
18      {children}
19    </DoraCellProvider>
20  );
21}

1import { useCall, useConnectionStatus } from "@dora-cell/sdk-react";
2 
3export function Dialer() {
4  const { call, callStatus, callDuration } = useCall();
5  const { isConnected, connectionStatus, logout } = useConnectionStatus();
6 
7  return (
8    <div>
9      <div className="flex justify-between items-center mb-4">
10        <p>Status: {connectionStatus}</p>
11        {isConnected && (
12          <button onClick={() => logout()} className="text-red-500 text-sm">
13            Sign out
14          </button>
15        )}
16      </div>
17      {callStatus === "ongoing" && <p>{callDuration}</p>}
18      <button 
19        onClick={() => call("+2348000000000")}
20        disabled={!isConnected || callStatus !== "idle"}
21      >
22        {callStatus === "idle" ? "Call" : "Calling..."}
23      </button>
24    </div>
25  );
26}

1import { useState } from "react";
2import { CallInterface, Dialpad, CreditBalance } from "@dora-cell/sdk-react";
3 
4function App() {
5  const [dialerOpen, setDialerOpen] = useState(false);
6 
7  return (
8    <>
9      <header>
10        <CreditBalance />
11      </header>
12      
13      {/* Handles all incoming and outgoing call UI */}
14      <CallInterface 
15        isOpen={dialerOpen} 
16        onOpenChange={setDialerOpen} 
17        onCallEnded={() => console.log('Call Ended')}
18      />
19      
20      <main>
21        <Dialpad 
22          initialNumber="+2348000000000"
23          showKeys={true}
24          metadata={{ source: "docs" }}
25          onCallInitiated={(num) => console.log('Calling', num)}
26        />
27      </main>
28    </>
29  );
30}

1<!-- For Staging / Sandbox testing, replace core.js with core.staging.js -->
2<script src="https://esm.sh/@dora-cell/ghl@latest/dist/core.staging.js"></script>