Quickstart

Install the stack and send a message in about five minutes.

Run locally

Start the stack

cp .env.example .env
./scripts/up.sh

Open http://localhost:8080. The browser talks same-origin ws://localhost:8080/ws.

On a fresh volume with EFELANT_SEED=1:

alice / password123
bob   / password123

Self-host with EFELANT_SEED=0 and use create-an-account. Do not ship the development passwords. Full paths: Self-host.

First integrations

Embed a conversation

<efelant-conversation
  tenant-id="…"
  context-type="access_request"
  external-id="AR-123">
</efelant-conversation>

Publish a status in the same transaction

BEGIN;
UPDATE access_requests SET status = 'approved' WHERE id = 'AR-123';
SELECT efelant.publish_status(
  p_tenant_id => '…',
  p_context_type => 'access_request',
  p_external_id => 'AR-123',
  p_status => 'approved',
  p_message => 'Access request approved'
);
COMMIT;

Call from another app

curl -s http://localhost:18080/health
curl -s http://localhost:18081/efelant.v1.Efelant/Health \
  -H "Content-Type: application/json" -d '{}'

Issue an API client as a tenant admin, then send Authorization: Bearer efl_…. Details: REST / gRPC.