freescout/freescout2ant
0
0
Fork 0
mirror of https://gh.wpcy.net/https://github.com/hayBIT/freescout2ant.git synced 2026-07-14 19:48:36 +08:00
Code Issues Projects Releases Packages Activity Actions
FreeScout module to connect to Ameise API
155 commits 47 branches 0 tags 14 MiB
Find a file
Exact
Claude 3c3a092f7a
Track failed Ameise archive attempts and add retry tooling 
Previously a thread could be skipped silently in ConversationArchiver
(no customer match, ambiguous match, API/network error, attachment
failure) without any record. Default-off logging hid the cause, and the
queue job swallowed exceptions, so messages "archived" in FreeScout
never surfaced as missing in Ameise.

Now every archive attempt records a row in the new crm_archive_attempts
table with status, sanitized HTTP response, attempt counter and
resolution timestamp. ArchiveThreadsJob retries transient failures up to
5 times with exponential backoff; ameise:list-failed-archives and
ameise:retry-failed-archives expose the queue from the CLI; the Ameise
settings page lists open failures with retry/dismiss buttons.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VU73s4KM5JZqVWQYPpK3cP
2026-06-16 23:06:49 +00:00
.github Revert "clear git cache" 2023-07-21 16:25:32 +05:30
Config Disable verbose Ameise logging by default 2025-12-13 11:43:20 +01:00
Console Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
Database Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
Entities Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
Http Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
Jobs Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
Providers Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
Public Use POST body mail parameter for Ameise email search 2026-04-14 23:09:59 +02:00
Resources Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
Services Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +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 Track failed Ameise archive attempts and add retry tooling 2026-06-16 23:06:49 +00:00
start.php new code 2023-09-16 16:00:05 +05:30

README.md

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.

Tracking fehlgeschlagener Archivierungen

Auch bei deaktiviertem AMEISE_LOG_STATUS werden Fehlversuche dauerhaft in der Tabelle crm_archive_attempts festgehalten (Grund, HTTP-Status, bereinigte Response). Konkrete Status:

  • failed_no_customer / failed_ambiguous_customer – kein eindeutiger Ameise-Kunde zur Mailadresse
  • failed_api – Ameise hat per HTTP gemeldet, dass die Archivierung nicht klappt
  • failed_token – Tokenfehler beim Aufruf
  • failed_attachment – Hauptnachricht ist angekommen, Anhänge teils nicht
  • failed_exception – unerwartete Exception (nach allen Queue-Retries endgültig)

Tools:

  • CLI: php artisan ameise:list-failed-archives [--since=24h] [--status=failed_api]
  • CLI: php artisan ameise:retry-failed-archives --conversation=123 oder --id=456 oder --all
  • UI: Settings → Ameise → Sektion „Archivierungs-Fehler" listet offene Fälle mit „Erneut versuchen"/„Erledigt"-Buttons

ArchiveThreadsJob versucht Exceptions automatisch bis zu 5× (Backoff 1 min / 5 min / 15 min / 1 h / 4 h) erneut; der Cron ameise:archive-threads greift offene Threads zusätzlich alle 5 Minuten wieder auf.

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.).