Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
/**
* 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,
});
}
}