CRM

email

14 uç · /api/crm/v1/email

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 14 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

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}/testte 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}/forward-test

POST /email/channels/{id}/forward-test — yönlendirme kanalının adresine (ör.

OturumYol parametresi: id

hello@bimarka.com) TEST postası gönder. Sağlayıcı onu kanala yönlendirince forward_verified_at dolar (platform_yanit); panel kanalı yoklayarak "çalışıyor" der. Yanıt 200 + {ok, message} (gönderim KAPALIYSA da 200: bu, kullanıcının öğrenmek istediği cevaptır — test_email_channel_h deseni).

İstek
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/email/channels/<id>/forward-test" \
  -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…"
}
GET/api/crm/v1/email/provider

GET /email/provider?address= — adresin posta sağlayıcısı (MX). Panel yönlendirme

Oturum

talimatını buna göre çizer (Google · Microsoft · Yandex · Zoho · iCloud · Yahoo · Blesyum Mail · diğer). MX okunamazsa diger — hata DEĞİL, genel talimat.

İstek
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/email/provider" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/crm/v1/internal/email/platform-reply

POST [posta::YANIT_YOLU].

Dahili

Durum kodları bmail'in kararıdır: 2xx teslim edildi · 4xx KALICI (yeniden denemez) · 5xx geçici (yeniden dener). Bu yüzden DB hatası 503, bilinmeyen jeton 422 — ikisini karıştırmak ya yanıtı sonsuza dek denetir ya da sessizce düşürür.

İstek
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/internal/email/platform-reply" \
  -H "X-Blesyum-Internal: <imza>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al