FreeScout module to connect to Ameise API
Find a file
Claude 6eb4e8dfc2
Add API selection between MitarbeiterWebservice and Customer Archives/Stocks
Introduces an "Archive API" setting that switches both reads and writes
between the legacy MitarbeiterWebservice API and the new Customer Archives
(write) + Stocks (read) APIs.

- New write strategy (ArchiveWriterInterface + factory): legacy header-based
  writer and a Customer Archives JSON writer (CreateArchiveRequestDto, files as
  base64 data URIs, one entry per attachment), backed by CustomerArchivesApiClient.
- New read strategy (CrmReadClientInterface + factory): legacy delegate and a
  StocksReadClient that normalizes Stocks responses (customers/names,
  communications, contracts, contract lines/states) to the legacy shape so the
  controller/frontend stay unchanged.
- Hybrid: customer lookup by e-mail stays on MitarbeiterWebservice because the
  Stocks API cannot search by e-mail.
- Settings: ameise_api + ameise_archive_is_public dropdowns, env-backed base
  URLs for both new APIs (test/live), German translations.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KfJdbw4dRvJdcihTkKt69T
2026-06-25 13:23:16 +00:00
.github Revert "clear git cache" 2023-07-21 16:25:32 +05:30
Config Add API selection between MitarbeiterWebservice and Customer Archives/Stocks 2026-06-25 13:23:16 +00:00
Console adapt ArchiveThreads.php 2025-05-12 14:03:20 +02:00
Database fix: Migration NPE — Null-Check und User-ID statt Objekt verwenden 2026-03-17 09:21:18 +00:00
Entities Add Thread import 2025-06-04 11:27:40 +02:00
Http Add API selection between MitarbeiterWebservice and Customer Archives/Stocks 2026-06-25 13:23:16 +00:00
Jobs Add API selection between MitarbeiterWebservice and Customer Archives/Stocks 2026-06-25 13:23:16 +00:00
Providers Add API selection between MitarbeiterWebservice and Customer Archives/Stocks 2026-06-25 13:23:16 +00:00
Public Suchfeld im Ameise-Modal automatisch fokussieren 2026-06-24 13:50:01 +00:00
Resources Add API selection between MitarbeiterWebservice and Customer Archives/Stocks 2026-06-25 13:23:16 +00:00
Services Add API selection between MitarbeiterWebservice and Customer Archives/Stocks 2026-06-25 13:23:16 +00:00
composer.json add composer description 2025-05-10 00:52:22 +02:00
LICENSE.md add LICENSE.md 2024-04-12 14:28:22 +02:00
module.json package update 2023-12-20 17:44:05 +05:30
README.md docs: #scanonly Feature in README dokumentiert 2026-03-16 22:02:00 +00:00
start.php new code 2023-09-16 16:00:05 +05:30

Ameise Freescout Package

Installation

  1. Download the latest module zip file via the releases card on the right.
  2. Transfer the zip file to the server in the Modules/AmeiseModule folder of FreeScout.
  3. Unpack the zip file.
  4. Remove the zip file.
  5. Activate the module via the Modules page in FreeScout. Log in to Ameise to connect.

Update instructions

  1. Download the latest module zip file via the releases card on the right.
  2. Transfer the zip file to the server in the Modules/AmeiseModule folder of FreeScout.
  3. Remove the content of the folder AmeiseModule
  4. Unpack the zip file.
  5. Remove the zip file.
  6. Activate the module via the Modules page in FreeScout.

Logging

Verbose module logs (including Cron-Logeinträge) are disabled by default to avoid ein übermäßiges Wachstum der activity_logs-Tabelle. Bei Bedarf können Sie sie über die Umgebungsvariable AMEISE_LOG_STATUS=true wieder aktivieren.

Attachment Handling

Image attachments are automatically converted to PDF before being archived.

Scan Only Modus

Wenn der Betreff einer E-Mail #scanonly enthält, werden nur die Anhänge archiviert die E-Mail selbst wird nicht an Ameise übertragen. Die Erkennung ist case-insensitive (#scanonly, #SCANONLY, #ScanOnly etc.).