Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

1.6 KB
Raw Blame
/**
 * Calls resource — incoming-call handling.
 *
 * Backed by `src/modules/call/call.controller.ts` (`@Controller('sessions/:sessionId/calls')`).
 * @packageDocumentation
 */

import { encodeSegment } from '../http.js';
import type { OpenWAClient } from '../client.js';
import type { CallLinkResponse, CreateCallLinkRequest, SuccessResult } from '../types.js';

export class CallsResource {
  constructor(private readonly client: OpenWAClient) {}

  /**
   * Reject a ringing incoming call. **Baileys only**: whatsapp-web.js answers 501.
   * The `callId` comes from the `call.received` webhook/socket event; the server
   * answers 404 when the call is not found or no longer ringing. Requires an
   * OPERATOR-level key.
   */
  rejectCall(sessionId: string, callId: string): Promise<SuccessResult> {
    return this.client.request<SuccessResult>({
      method: 'POST',
      path: `/api/sessions/${encodeSegment(sessionId)}/calls/${encodeSegment(callId)}/reject`,
    });
  }

  /**
   * Create a shareable WhatsApp call link.
   *
   * Both fields are required. `startTime` is absolute epoch MILLISECONDS — a link for right now is
   * `Date.now()` rather than an omitted field, because whatsapp-web.js generates an event-linked
   * call and has no notion of "no start time". A WhatsApp-side failure answers `403` rather than a
   * success carrying an empty link.
   */
  createLink(sessionId: string, body: CreateCallLinkRequest): Promise<CallLinkResponse> {
    return this.client.request<CallLinkResponse>({
      method: 'POST',
      path: `/api/sessions/${encodeSegment(sessionId)}/calls/link`,
      body,
    });
  }
}