Internal APIs
Internal APIs are service-to-service endpoints intended for Agent, not for the web frontend.Purpose
Agent receives natural language and channel events. Platform owns the final business action. Internal APIs are the bridge between both services.Authentication
Internal APIs require the internal service token environment variable configured in both Platform and Agent/infra. If the token is missing or wrong, Agent must fail fast rather than silently running without Platform integration.Main internal operations
Idempotency
Writes from Agent should include an idempotency key derived from the source message ID. This protects against duplicated webhook deliveries.Operational note
If Agent replies to users but Platform does not show new data, check:- Agent logs for Platform HTTP errors.
- Platform internal auth errors.
- Idempotency conflicts.
- User channel resolution.
- Database write errors.