# Neofir

> Neofir is a builder for conversational agents that run on the messaging surfaces a customer already uses — an embeddable web widget, Instagram DM, Facebook Messenger, and WhatsApp Business. One agent is configured once and answers across all four. The runtime contains no vertical-specific code paths; behaviour is determined by configuration.

The platform is structured around five primitives: a personality (role, environment, tone, goal, guardrails), a knowledge base (documents indexed for retrieval-augmented generation), a set of tools the agent may invoke (booking, lookup, escalation, integration calls), the channels the agent is connected to, and an operator inbox where humans can take over a conversation. Documentation below describes each primitive, the per-channel constraints, and the wire-level reference for integrators.

## Docs

- [Welcome](https://neofir.com/docs/): overview of the platform, surfaces, and where to read next
- [Quickstart](https://neofir.com/docs/quickstart.html): end-to-end walkthrough from signup to a live agent on one channel
- [Pricing](https://neofir.com/docs/pricing.html): plans, conversation limits, billing model
- [Security & GDPR](https://neofir.com/docs/security.html): data handling, hosting region, sub-processors, compliance posture
- [Status & roadmap](https://neofir.com/docs/status.html): platform status and upcoming work

## Concepts

- [Personality (PETG)](https://neofir.com/docs/concepts/personality.html): the five fields that shape every reply — role, environment, tone, goal, guardrails
- [Knowledge (RAG)](https://neofir.com/docs/concepts/knowledge.html): document ingestion, chunking, retrieval, and prompt injection
- [Tools (Skills)](https://neofir.com/docs/concepts/tools.html): functions the agent may call to take action or fetch data
- [Channels](https://neofir.com/docs/concepts/channels.html): how the same agent is exposed across multiple messaging surfaces
- [Operator inbox](https://neofir.com/docs/concepts/inbox.html): human takeover, severity routing, conversation state
- [Calendar & bookings](https://neofir.com/docs/concepts/calendar.html): internal availability model and optional Google Calendar sync

## Channels

- [Web widget](https://neofir.com/docs/channels/widget.html): embeddable browser widget, session model, theming, host-page API
- [Instagram DM](https://neofir.com/docs/channels/instagram.html): Instagram Direct integration via Meta Graph API
- [Facebook Messenger](https://neofir.com/docs/channels/messenger.html): Messenger Platform integration, page tokens, message tags
- [WhatsApp Business](https://neofir.com/docs/channels/whatsapp.html): WhatsApp Business integration, template messages, 24-hour window

## Reference

- [Widget API](https://neofir.com/docs/reference/api.html): browser-side widget API, init, identify, events
- [Webhooks](https://neofir.com/docs/reference/webhooks.html): outbound webhooks for conversation, lead, and booking events
- [Data model](https://neofir.com/docs/reference/data-model.html): conversation, message, contact, booking entities

## Optional

- [Manifesto](https://neofir.com): positioning and philosophy on the landing page
- [Playbook](https://neofir.com/playbook.html): long-form reference on how a conversational agent operates across channels