email — CRM API

GET/api/crm/v1/email/blesyum-mailboxes

`GET /email/blesyum-mailboxes` — bağlanabilecek Blesyum Mail kutuları.

Oturum

Lisans yoksa **hata değil, boş liste + gerekçe** döner: ekran "Mail aboneliğin yok" diyebilmeli. 4xx dönmek panelin genel hata kapısını tetikler ve kullanıcı sebebi hiç göremezdi (aynı ders `channels/{id}/test`te de alınmıştı).

İstek

curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/email/blesyum-mailboxes" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/crm/v1/email/bounce/{provider}/{routing_token}

PUBLIC: `/api/crm/v1/email/bounce/{provider}/{routing_token}` — başarısız giden mail →

Herkese açıkYol parametresi: providerrouting_token

"Failed Email Delivery Report" ticket (bedesk CreateTicketForFailedOutgoingEmail).

İstek

curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/email/bounce/<provider>/<routing_token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/crm/v1/email/channels

List email channels

Oturum

İstek

curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/crm/v1/email/channels

Create email channel

Oturum

İstek

curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/crm/v1/email/channels/{id}

Get email channel

OturumYol parametresi: id

İstek

curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PUT/api/crm/v1/email/channels/{id}

Update email channel

OturumYol parametresi: id

İstek

curl -X PUT "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

DELETE/api/crm/v1/email/channels/{id}

Delete email channel

OturumYol parametresi: id

İstek

curl -X DELETE "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/crm/v1/email/channels/{id}/rotate-token

Rotate email channel token

OturumYol parametresi: id

İstek

curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels/<id>/rotate-token" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/crm/v1/email/channels/{id}/test

`POST /email/channels/{id}/test` — IMAP kanalına ŞİMDİ bağlanmayı dene.

OturumYol parametresi: id

Yanıt HER ZAMAN 200'dür ve sonucu gövde taşır (`{ok, message}`): "bağlanamadım" bir SUNUCU hatası değil, kullanıcının öğrenmek istediği CEVAPtır. 4xx/5xx dönmek panelin genel hata kapısını tetikler ve kullanıcı sebebi hiç göremezdi.

İstek

curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels/<id>/test" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/crm/v1/email/inbound-log/{id}/download

Gelen ham e-postayı (OriginalReplyEmail) indir — inbound_email_log.storage_key →

OturumYol parametresi: id

blesyum-storage JSON. (BLE-1707.)

İstek

curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/email/inbound-log/<id>/download" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/crm/v1/email/inbound/{provider}/{routing_token}

PUBLIC: `/api/crm/v1/email/inbound/{provider}/{routing_token}` — gelen e-posta.

Herkese açıkYol parametresi: providerrouting_token

İstek

curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/email/inbound/<provider>/<routing_token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}