@zavudev/sdk 0.55.0 → 0.57.0

package/resources/broadcasts/broadcasts.mjs

@@ -153,15 +153,22 @@ export class Broadcasts extends APIResource {
     /**
      * Start sending the broadcast immediately or schedule for later.
      *
-     * **Verification is required to send, except on WhatsApp.** On every channel other
-     * than `whatsapp`, the team must have completed both identity verification (KYC)
-     * and business verification (KYB); passing one is not enough. A `whatsapp`
-     * broadcast requires neither: it can only be built on a template, and Meta vets
-     * the business and the content when it approves that template, so an unapproved
-     * template is refused instead. `smart` is not exempt — it can route a contact to
-     * SMS or email. Drafts can be created, edited and kept without any check. Every
-     * send path — dashboard, API and CLI alike — enforces the same rule, returning
-     * `403` with code `kyc_required` or `kyb_required` for whichever is outstanding.
+     * **The account must be past the unverified level to send, except on WhatsApp.**
+     * An account that has verified nothing is refused with `403` and code
+     * `kyc_required` on every channel other than `whatsapp`. Any one of these lifts
+     * it: identity verification (KYC), a saved payment method, a settled deposit, or a
+     * paid plan. Business verification (KYB) is not required to broadcast; it gates
+     * 10DLC registration only. A `whatsapp` broadcast is exempt: it can only be built
+     * on a template, and Meta vets the business and the content when it approves that
+     * template, so an unapproved template is refused instead. `smart` is not exempt,
+     * since it can route a contact to SMS or email. Drafts can be created, edited and
+     * kept without any check. Every send path (dashboard, API and CLI) enforces the
+     * same rule.
+     *
+     * **Daily ceilings apply per recipient.** Each message a broadcast sends counts
+     * against the channel's daily ceiling (see `POST /v1/messages`). Once the ceiling
+     * is reached, the remaining recipients are marked `failed` with `errorCode`
+     * `DAILY_LIMIT_EXCEEDED`; they are not retried the next day.
      *
      * **Review depends on the channel, and cannot be bypassed.** A draft is submitted
      * to automated content review here; it does not go straight out. A WhatsApp

package/resources/broadcasts/broadcasts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"broadcasts.mjs","sourceRoot":"","sources":["../../src/resources/broadcasts/broadcasts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"broadcasts.mjs","sourceRoot":"","sources":["../../src/resources/broadcasts/broadcasts.ts"],"names":[],"mappings":"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"}

package/resources/calls.d.mts

@@ -0,0 +1,539 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { Cursor, type CursorParams, PagePromise } from "../core/pagination.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Calls extends APIResource {
+    /**
+     * Place an outbound voice call answered by the voice agent configured on the
+     * sender. Zavu dials the recipient and runs the conversation through its managed
+     * voice pipeline (speech recognition, the agent's LLM, and speech synthesis, with
+     * real-time interruption handling).
+     *
+     * **Requirements:**
+     *
+     * - The Voice Agents feature must be enabled for your team (otherwise `403`).
+     * - An account that has verified nothing may only call the phone numbers the
+     *   project has verified (`403` with code `destination_not_verified`, and
+     *   `details.verifiedNumbers` lists them), and at most 5 calls a day (`429` with
+     *   code `daily_limit_exceeded`). A number is verified from the dashboard's
+     *   Sandbox screen by sending the pre-filled WhatsApp message from that phone; the
+     *   same verification covers SMS and calls. Verify your identity, add a payment
+     *   method, settle a deposit or subscribe to call any destination. That raises the
+     *   ceiling to 50 calls a day on Free; paid plans have no daily call ceiling. Full
+     *   reference: https://docs.zavu.dev/concepts/sending-limits
+     * - The sender's agent must have `voice.enabled` set to `true`.
+     * - Not available with test-mode API keys.
+     *
+     * **Billing:** Voice calls are billed per minute of connected time plus telephony,
+     * deducted from your prepaid balance. A short-duration estimate is reserved when
+     * the call is placed; you are charged for the actual duration when the call ends.
+     *
+     * @example
+     * ```ts
+     * const call = await client.calls.create({
+     *   to: '+56912345678',
+     * });
+     * ```
+     */
+    create(body: CallCreateParams, options?: RequestOptions): APIPromise<CallCreateResponse>;
+    /**
+     * Retrieve a single voice call, including its full transcript once the
+     * conversation has produced turns.
+     *
+     * @example
+     * ```ts
+     * const call = await client.calls.retrieve('callId');
+     * ```
+     */
+    retrieve(callID: string, options?: RequestOptions): APIPromise<CallRetrieveResponse>;
+    /**
+     * List voice calls for this project, most recent first. Transcripts are omitted
+     * from the list; fetch a single call to get its transcript.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const callListResponse of client.calls.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: CallListParams | null | undefined, options?: RequestOptions): PagePromise<CallListResponsesCursor, CallListResponse>;
+    /**
+     * End an active voice call. The call must still be ringing or in progress. Not
+     * available with test-mode API keys.
+     *
+     * @example
+     * ```ts
+     * const response = await client.calls.hangup('callId');
+     * ```
+     */
+    hangup(callID: string, options?: RequestOptions): APIPromise<CallHangupResponse>;
+}
+export type CallListResponsesCursor = Cursor<CallListResponse>;
+export interface CallCreateResponse {
+    call: CallCreateResponse.Call;
+}
+export declare namespace CallCreateResponse {
+    interface Call {
+        id: string;
+        createdAt: string;
+        /**
+         * Whether the call was placed by Zavu (outbound) or received from a caller
+         * (inbound).
+         */
+        direction: 'inbound' | 'outbound';
+        /**
+         * Caller phone number in E.164 format. Your sender's number for outbound calls;
+         * the caller's number for inbound calls.
+         */
+        from: string;
+        /**
+         * Lifecycle status of a voice call.
+         *
+         * - `queued`: outbound call created, not yet dialing.
+         * - `ringing`: dialing (outbound) or received and ringing (inbound).
+         * - `in_progress`: answered, the agent is connected.
+         * - `completed`: ended after a conversation.
+         * - `failed`: could not be completed.
+         * - `busy`: the line was busy.
+         * - `no_answer`: rang but was not answered.
+         * - `canceled`: canceled before it was answered.
+         */
+        status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+        /**
+         * Callee phone number in E.164 format.
+         */
+        to: string;
+        /**
+         * When the call was answered.
+         */
+        answeredAt?: string | null;
+        /**
+         * Total cost of the call in USD, combining the managed voice pipeline per-minute
+         * charge and telephony. Available once the call has ended.
+         */
+        cost?: number | null;
+        /**
+         * Billable talk time in seconds, measured from answer to hangup.
+         */
+        durationSeconds?: number | null;
+        /**
+         * When the call ended.
+         */
+        endedAt?: string | null;
+        /**
+         * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+         * Present once the call is no longer active.
+         */
+        endReason?: string | null;
+        /**
+         * Arbitrary metadata you attached when creating the call.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * Ordered transcript of the call. Included when retrieving a single call; omitted
+         * from list responses.
+         */
+        transcript?: Array<Call.Transcript>;
+        /**
+         * Number of conversation turns exchanged during the call.
+         */
+        turnCount?: number | null;
+        updatedAt?: string;
+    }
+    namespace Call {
+        /**
+         * A single turn in a voice call transcript.
+         */
+        interface Transcript {
+            /**
+             * Who produced the turn. `tool` records a tool call the agent made during the
+             * conversation.
+             */
+            role: 'user' | 'assistant' | 'tool';
+            /**
+             * Ordinal position of the turn within the call, starting at 0.
+             */
+            seq: number;
+            /**
+             * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+             * tool call for `tool` turns.
+             */
+            text: string;
+            /**
+             * When the turn ended.
+             */
+            endedAt?: string | null;
+            /**
+             * When the turn started.
+             */
+            startedAt?: string | null;
+        }
+    }
+}
+export interface CallRetrieveResponse {
+    call: CallRetrieveResponse.Call;
+}
+export declare namespace CallRetrieveResponse {
+    interface Call {
+        id: string;
+        createdAt: string;
+        /**
+         * Whether the call was placed by Zavu (outbound) or received from a caller
+         * (inbound).
+         */
+        direction: 'inbound' | 'outbound';
+        /**
+         * Caller phone number in E.164 format. Your sender's number for outbound calls;
+         * the caller's number for inbound calls.
+         */
+        from: string;
+        /**
+         * Lifecycle status of a voice call.
+         *
+         * - `queued`: outbound call created, not yet dialing.
+         * - `ringing`: dialing (outbound) or received and ringing (inbound).
+         * - `in_progress`: answered, the agent is connected.
+         * - `completed`: ended after a conversation.
+         * - `failed`: could not be completed.
+         * - `busy`: the line was busy.
+         * - `no_answer`: rang but was not answered.
+         * - `canceled`: canceled before it was answered.
+         */
+        status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+        /**
+         * Callee phone number in E.164 format.
+         */
+        to: string;
+        /**
+         * When the call was answered.
+         */
+        answeredAt?: string | null;
+        /**
+         * Total cost of the call in USD, combining the managed voice pipeline per-minute
+         * charge and telephony. Available once the call has ended.
+         */
+        cost?: number | null;
+        /**
+         * Billable talk time in seconds, measured from answer to hangup.
+         */
+        durationSeconds?: number | null;
+        /**
+         * When the call ended.
+         */
+        endedAt?: string | null;
+        /**
+         * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+         * Present once the call is no longer active.
+         */
+        endReason?: string | null;
+        /**
+         * Arbitrary metadata you attached when creating the call.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * Ordered transcript of the call. Included when retrieving a single call; omitted
+         * from list responses.
+         */
+        transcript?: Array<Call.Transcript>;
+        /**
+         * Number of conversation turns exchanged during the call.
+         */
+        turnCount?: number | null;
+        updatedAt?: string;
+    }
+    namespace Call {
+        /**
+         * A single turn in a voice call transcript.
+         */
+        interface Transcript {
+            /**
+             * Who produced the turn. `tool` records a tool call the agent made during the
+             * conversation.
+             */
+            role: 'user' | 'assistant' | 'tool';
+            /**
+             * Ordinal position of the turn within the call, starting at 0.
+             */
+            seq: number;
+            /**
+             * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+             * tool call for `tool` turns.
+             */
+            text: string;
+            /**
+             * When the turn ended.
+             */
+            endedAt?: string | null;
+            /**
+             * When the turn started.
+             */
+            startedAt?: string | null;
+        }
+    }
+}
+export interface CallListResponse {
+    id: string;
+    createdAt: string;
+    /**
+     * Whether the call was placed by Zavu (outbound) or received from a caller
+     * (inbound).
+     */
+    direction: 'inbound' | 'outbound';
+    /**
+     * Caller phone number in E.164 format. Your sender's number for outbound calls;
+     * the caller's number for inbound calls.
+     */
+    from: string;
+    /**
+     * Lifecycle status of a voice call.
+     *
+     * - `queued`: outbound call created, not yet dialing.
+     * - `ringing`: dialing (outbound) or received and ringing (inbound).
+     * - `in_progress`: answered, the agent is connected.
+     * - `completed`: ended after a conversation.
+     * - `failed`: could not be completed.
+     * - `busy`: the line was busy.
+     * - `no_answer`: rang but was not answered.
+     * - `canceled`: canceled before it was answered.
+     */
+    status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+    /**
+     * Callee phone number in E.164 format.
+     */
+    to: string;
+    /**
+     * When the call was answered.
+     */
+    answeredAt?: string | null;
+    /**
+     * Total cost of the call in USD, combining the managed voice pipeline per-minute
+     * charge and telephony. Available once the call has ended.
+     */
+    cost?: number | null;
+    /**
+     * Billable talk time in seconds, measured from answer to hangup.
+     */
+    durationSeconds?: number | null;
+    /**
+     * When the call ended.
+     */
+    endedAt?: string | null;
+    /**
+     * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+     * Present once the call is no longer active.
+     */
+    endReason?: string | null;
+    /**
+     * Arbitrary metadata you attached when creating the call.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Ordered transcript of the call. Included when retrieving a single call; omitted
+     * from list responses.
+     */
+    transcript?: Array<CallListResponse.Transcript>;
+    /**
+     * Number of conversation turns exchanged during the call.
+     */
+    turnCount?: number | null;
+    updatedAt?: string;
+}
+export declare namespace CallListResponse {
+    /**
+     * A single turn in a voice call transcript.
+     */
+    interface Transcript {
+        /**
+         * Who produced the turn. `tool` records a tool call the agent made during the
+         * conversation.
+         */
+        role: 'user' | 'assistant' | 'tool';
+        /**
+         * Ordinal position of the turn within the call, starting at 0.
+         */
+        seq: number;
+        /**
+         * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+         * tool call for `tool` turns.
+         */
+        text: string;
+        /**
+         * When the turn ended.
+         */
+        endedAt?: string | null;
+        /**
+         * When the turn started.
+         */
+        startedAt?: string | null;
+    }
+}
+export interface CallHangupResponse {
+    call: CallHangupResponse.Call;
+}
+export declare namespace CallHangupResponse {
+    interface Call {
+        id: string;
+        createdAt: string;
+        /**
+         * Whether the call was placed by Zavu (outbound) or received from a caller
+         * (inbound).
+         */
+        direction: 'inbound' | 'outbound';
+        /**
+         * Caller phone number in E.164 format. Your sender's number for outbound calls;
+         * the caller's number for inbound calls.
+         */
+        from: string;
+        /**
+         * Lifecycle status of a voice call.
+         *
+         * - `queued`: outbound call created, not yet dialing.
+         * - `ringing`: dialing (outbound) or received and ringing (inbound).
+         * - `in_progress`: answered, the agent is connected.
+         * - `completed`: ended after a conversation.
+         * - `failed`: could not be completed.
+         * - `busy`: the line was busy.
+         * - `no_answer`: rang but was not answered.
+         * - `canceled`: canceled before it was answered.
+         */
+        status: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+        /**
+         * Callee phone number in E.164 format.
+         */
+        to: string;
+        /**
+         * When the call was answered.
+         */
+        answeredAt?: string | null;
+        /**
+         * Total cost of the call in USD, combining the managed voice pipeline per-minute
+         * charge and telephony. Available once the call has ended.
+         */
+        cost?: number | null;
+        /**
+         * Billable talk time in seconds, measured from answer to hangup.
+         */
+        durationSeconds?: number | null;
+        /**
+         * When the call ended.
+         */
+        endedAt?: string | null;
+        /**
+         * Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+         * Present once the call is no longer active.
+         */
+        endReason?: string | null;
+        /**
+         * Arbitrary metadata you attached when creating the call.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+        /**
+         * Ordered transcript of the call. Included when retrieving a single call; omitted
+         * from list responses.
+         */
+        transcript?: Array<Call.Transcript>;
+        /**
+         * Number of conversation turns exchanged during the call.
+         */
+        turnCount?: number | null;
+        updatedAt?: string;
+    }
+    namespace Call {
+        /**
+         * A single turn in a voice call transcript.
+         */
+        interface Transcript {
+            /**
+             * Who produced the turn. `tool` records a tool call the agent made during the
+             * conversation.
+             */
+            role: 'user' | 'assistant' | 'tool';
+            /**
+             * Ordinal position of the turn within the call, starting at 0.
+             */
+            seq: number;
+            /**
+             * Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+             * tool call for `tool` turns.
+             */
+            text: string;
+            /**
+             * When the turn ended.
+             */
+            endedAt?: string | null;
+            /**
+             * When the turn started.
+             */
+            startedAt?: string | null;
+        }
+    }
+}
+export interface CallCreateParams {
+    /**
+     * Recipient phone number in E.164 format.
+     */
+    to: string;
+    /**
+     * Overrides the agent's configured greeting for this call only.
+     */
+    greeting?: string;
+    /**
+     * Language the agent speaks on this call only, as a BCP-47 tag (`en`, `es`,
+     * `es-ES`, `pt-BR`), or `auto` to detect the caller's language and follow it.
+     * Overrides the agent's configured language for speech recognition, the agent's
+     * replies, and the synthesized voice. If the agent uses a custom voice you
+     * supplied, that voice is kept and only the language changes. When omitted, the
+     * agent's configured language is used.
+     */
+    language?: string;
+    /**
+     * Overrides the agent's maximum call duration for this call only.
+     */
+    maxDurationMinutes?: number;
+    /**
+     * Arbitrary metadata to associate with the call. Returned on the call object and
+     * included in voice webhooks.
+     */
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Sender profile that places the call. Uses the project's default sender if
+     * omitted. The sender's agent must have voice enabled.
+     */
+    senderId?: string;
+}
+export interface CallListParams extends CursorParams {
+    /**
+     * Whether the call was placed by Zavu (outbound) or received from a caller
+     * (inbound).
+     */
+    direction?: 'inbound' | 'outbound';
+    /**
+     * Lifecycle status of a voice call.
+     *
+     * - `queued`: outbound call created, not yet dialing.
+     * - `ringing`: dialing (outbound) or received and ringing (inbound).
+     * - `in_progress`: answered, the agent is connected.
+     * - `completed`: ended after a conversation.
+     * - `failed`: could not be completed.
+     * - `busy`: the line was busy.
+     * - `no_answer`: rang but was not answered.
+     * - `canceled`: canceled before it was answered.
+     */
+    status?: 'queued' | 'ringing' | 'in_progress' | 'completed' | 'failed' | 'busy' | 'no_answer' | 'canceled';
+}
+export declare namespace Calls {
+    export { type CallCreateResponse as CallCreateResponse, type CallRetrieveResponse as CallRetrieveResponse, type CallListResponse as CallListResponse, type CallHangupResponse as CallHangupResponse, type CallListResponsesCursor as CallListResponsesCursor, type CallCreateParams as CallCreateParams, type CallListParams as CallListParams, };
+}
+//# sourceMappingURL=calls.d.mts.map

package/resources/calls.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.mts","sourceRoot":"","sources":["../src/resources/calls.ts"],"names":[],"mappings":"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"}