memoair-vapi 0.1.0

VAPI Custom Knowledge Base integration for MemoAir voice memory

memoair-vapi

Serve VAPI's Custom Knowledge Base webhook from MemoAir voice memory. Phase 1 retrieves from the shared org index.

Install

pip install memoair-vapi

Quick start

import json

from memoair_vapi import MemoAirVapiSearch, verify_vapi_signature

search = MemoAirVapiSearch(
    api_key="memoair_pk_...",
    project_id="proj_xxx",
    agent_id="agent_xxx",
    top_k=5,
)

# In your webhook handler (raw_body = exact request bytes):
if not verify_vapi_signature(raw_body, signature_header, secret):
    ...  # return 401

payload = json.loads(raw_body)
documents = await search.handle_request(payload)  # -> {"documents": [...]}

handle_request dispatches on message.type: knowledge-base-request returns documents; any other type is acked with {}. A malformed knowledge-base request raises VapiWebhookError (map it to HTTP 400). Retrieval failures degrade to {"documents": []} so a live call never breaks.

A runnable FastAPI server is in examples/vapi/.

Docs

https://docs.memoair.dev/voice/integrations/vapi