From 7e23234796073f20dc39f2a3842e543d715deeff Mon Sep 17 00:00:00 2001 From: jero-odoo Date: Mon, 28 Oct 2024 16:31:07 +0000 Subject: [PATCH] =?UTF-8?q?[IMP]=20General:=20Update=C2=A0manage=20inbound?= =?UTF-8?q?=20email=20doc?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit closes odoo/documentation#11308 X-original-commit: 1b14a732b9bceaf4d0b29b1986c76f87faaff899 Signed-off-by: Jessica Rogers (jero) Co-authored-by: ksc-odoo <73958186+ksc-odoo@users.noreply.github.com> Co-authored-by: Sam Lieber (sali) <36018073+samueljlieber@users.noreply.github.com> --- .../email_servers_inbound.rst | 40 ++++++++++++++++++ .../email_servers_inbound/allowed-domain.png | Bin 0 -> 7312 bytes 2 files changed, 40 insertions(+) create mode 100644 content/applications/general/email_communication/email_servers_inbound/allowed-domain.png diff --git a/content/applications/general/email_communication/email_servers_inbound.rst b/content/applications/general/email_communication/email_servers_inbound.rst index 8daf5809b1..ce786b0eec 100644 --- a/content/applications/general/email_communication/email_servers_inbound.rst +++ b/content/applications/general/email_communication/email_servers_inbound.rst @@ -317,3 +317,43 @@ To change the default behavior, enable :ref:`developer-mode`, then go to :menuse .. important:: These parameters are only used to prevent the creation of new records. They **do not prevent replies** from being added to the chatter. + +Allow alias domain system parameter +=================================== + +Incoming aliases are set in the Odoo database to create records by receiving incoming emails. To +view aliases set in the Odoo database, first activate the :ref:`developer mode `. +Then, go to :menuselection:`Settings app --> Technical --> Aliases`. + +The following system parameter, `mail.catchall.domain.allowed`, set with allowed alias domain +values, separated by commas, filters out correctly addressed emails to aliases. Setting the domains +for which the alias can create a ticket, lead, opportunity, etc., eliminates false positives where +email addresses with only the prefix alias, not the domain, are present. + +In some instances, matches have been made in the Odoo database when an email is received with the +same alias prefix and a different domain on the incoming email address. This is true in the sender, +recipient, and :abbr:`CC (Carbon Copy)` email addresses of an incoming email. + +.. example:: + When Odoo receives emails with the `commercial` prefix alias in the sender, recipient, or + :abbr:`CC (Carbon Copy)` email addresses (e.g. commercial\@example.com), the database falsely + treats the email as the full `commercial` alias, with a different domain, and therefore, creates + a ticket/lead/opportunity/etc. + +To add the `mail.catchall.domain.allowed` system parameter, first, activate the :ref:`developer mode +`. Then, go to :menuselection:`Settings app --> Technical --> System Parameters`. +Click :guilabel:`New`. Then, type in `mail.catchall.domain.allowed` for the :guilabel:`Key` field. + +Next, for the :guilabel:`Value` field, add the domains separated by commas. Manually +:icon:`fa-cloud-upload` :guilabel:`(Save)`, and the system parameter takes immediate effect. + +.. image:: email_servers_inbound/allowed-domain.png + :alt: mail.catchall.domain.allowed system parameter set. + +Local-part based incoming detection +=================================== + +When creating a new alias, there is an option to enable :guilabel:`Local-part based incoming +detection`. If enabled, Odoo only requires the local-part to match for routing an incoming email. If +this feature is turned off, Odoo requires the whole email address to match for routing an incoming +email. diff --git a/content/applications/general/email_communication/email_servers_inbound/allowed-domain.png b/content/applications/general/email_communication/email_servers_inbound/allowed-domain.png new file mode 100644 index 0000000000000000000000000000000000000000..22e7c5ed6ad3f269e61e255922e49ce7123b59d3 GIT binary patch literal 7312 zcma)9cTm$$ut%hdfD{2ilwJj-HxcOsqy&%>I-w*eAiaZxB190S1ZheOy%RbJiu4|O z?@~kW?fd-w|K7~onY-JW+r8P(-Dh|9qI9*@$nP=U!^6WP2dOLT;o;$9{^_4c?*5ze z^e^lGEu`<&P2BPDs6GB0cjoP%`rzT+#nXLlpaT3S7iJ1zV5vk-0W7It3IMB;3ScS* zZb=2ha{$=+&)^uW0N$wxkW>gzjT~GD07(T;N!1AdZUA!xfE2-hi`)!T79?#;0AP9; z01g2_NfE3QKM9<)w*o+GfT4tfHM|lB|98IPyN_TnfU5(5(P(2Z0Bixko}_~PA^_xV z07Eg>Hj3aHPeT_~u%V&F;J{FpEm+bxUBRucvwt#k8Bl!<*{cgSDBR1m00TFRz($pO z^Od9q@)e?YI@xJ!Wl9EQBk{go7Yy-I10QyNWoF=}V%D5G1PDLmPTd07vB|eEXJ9Ip+tJ=TJhLHbkoXPE0}D!PS-k|>KHl~r6D+_Z zy&aX~`wj1e&i+II6W@wlO#|e3q6SZ6mAHXZtT@QEc?U352M-J{`L&%xoFXfu{7ULN zyll)y){d0oW~Eh4z3VqSBh8!Jdg}|4cgLE_{!EP)h3$@(tsmWZxO?YJUXM2wP)m5K zv+{-*>Yfg##2`LUaau`)j;TAPHk<-KQ;^Z^TgbZE;Y0`EVz2WEh^y#f03~=fA1moO z%}g!*>YMUR`sr0Z4&ZvO=jtWA{sa`Xx7AgQx7RJo5 z65=t7A2Rxoz1f}t;M$zTd2VL1&lfw+*M@t7l{&w?r(uyq3|$Y`C4Soh*0M|^e1r5q zc7lSMrV^l!au*((lrA-Y%goA0hXw;%h4CYorjd2h5qZf;pRC5uzraj@vLtF#Eg0b9O8!w&#X_JJJ(i{_364mTS+1H1>{~xE&=1}*?q0(fGOY@P$-#I{td>% zdn5r;Rxt3H-bp9*pjBb)^tX!JN`Acxx%-TiXNlqg%WxQh0tZRhebQ&ekKMxfLt6Qi zNxY?O6$tM42z-3}iKI)3B~6fp?AZf~uS%_NBqEC!d$vr=n&)TA3jORGWJMp4fVxtF z!Ltny9nUxD%ZWFZZ?wK6@&9G!|1JAnE0HhX_a;x2kU{Vh9zlM1x*b{z@Q51c?ijy3 zj2O8fPr*;%rI5@_s4Z<3|=Wx5n;R+3*(m^_1g12A!S!Z?|iO!V# z3^@UYZJM}vVDU0>PJTX~tTyf9G%kPPJUsK*WnyumPZHUA;vi*FC7+HD1sDDg z>xWN08d9p8zL2I?t%nATF9!LHLFx-E)vvZC4Nja6Mo?OX4c^|YZ`d3(SJAsOh-L-| z7rNh$Y(5;*{>v(!;)g8GRCrTtAKEdL4IQvWBKm64sN6;P=AZk8$#E-F|IbR6NUWL`{E02#lca2T~xe% zWN%DOo(F@|$N+wltq&RHW2Q!L207TlcNYDvyvfP?%dft$YF)V1Y%=A4*sNNcvviJR zbYjX$zxZ;x948j!u9Sp%J0Hu~ypZ@SWrm6CPdhmzU^d9r{~oh<1YMtZUz;BX!#TMB$=`RzbL` z52S}8jdTVq3!TQ{ohmn+HA0B{%yoHKdpNn>8#`=U5bGWJBWS99P2hEm6su??mFZ^5 zdIR6K8rEW5y6Bn{Oi(Kg=#8~`*$pswZol&NEOTgH{H-)akxj9`J=R@?8WK%u;`SQv ze!!Y)GgT+yZ;PK!Ub?C@-CE!0<%QcX)|Y)<0GjUBjH=Fz5aYnrpeu&=(yS8O@ha?j z=iE*R-d=?W!Fwg4o|J!7fBd6hHKwZ4>8<>W>GY|>sc;N5se|jsR=4pAs3<=68T8Jl zd#l?h6p{{Pacb+5j{!lTCg!2xIU2GZe1f?r5gFB$(NY*^In+ERNT88 zsLu4%e%n5c*Req5_1jD!8g3?xyRf=gtsW5jQ`7YkL)AZpc&f79wV$CSO4pWzX6m;~ zR3m{G8O13PmOZw79W>xPFd^TvQ>iRg2&hm-!$RJ_&s-Rv3nR?QPAG;`HR5B zDd)TtMCYl?i4c6Q*IZJvAe~Z`#)y{%wuPkZnj4@D{Mx&Q?JMtSUVW!2Z@IIpR64Wly4^ zH+IqSDG!^UXJ+~w&*$LixjOx|rX!z-yr)_>d#(lPjh{YIpJ2-Bo#1e4+IZ9aW}2s@ zzF69Nc1hZLhVhUuQK(Zq56^o|ec;mmS=!m}Y3AE%zXw#w8`Bh`nwmfK>)v-WFuyQ^ z!`%*w$6F4f;#LYJgjSj(CE;+qn<@upg&))GC9E-~5UtXaxst;tme`J}hPxhEJ;2MD z0zmy`Bi4f0B~F&E%x#R~U!>%uXVdrS!m}}dD>ratdHJn$-+N_&!mJFRznM%eD=Llh zr6UkGn(De!&wG?!_miSAZ}rQ8Ch+~?kQwx)XAY)14D;EH|80vDR4G9R4xhd6Egz)h z7>l_SvxmzPikjMYM2KzAae8$;X?Dj`&J=7aG;y z7GuEE_;zDkFn{SJoo>U5lmkPmh@t0Lty+=_jnbdzE457!oop7bACZ)!y~zs;biz-T%=c@K1B0iA*vC61sG%U5l1V*UXjmQyWQD|+N^D;?!J7(Hm~i8-N|HK zAi)sc*0QdGGaD0sI8xL4Y;>&fBaV|(z>|IAUKsJ{$pJGuR(tY%1+M>5U{N;jGo?~Y z!RD_C3%HS&9pUB(?S0DJt%!rn@ehgLl>#Cs2dAm~I-cZN)}QRHiEQ$WpIhZG8`D3V z&=6&1}!dqe0N1@a&;=eG}AlIY?%C926Vc3 z%T+?HQ*-Fqcalm|Ulm9P)2v;<&h8-f^st9F=?{~6X=FCIZ9=mDe0PxTnEsj7r8WLg zNyfOS$@X>0F|Nz_io!a;vpc@y1=S}?XiXF^P1b5yfeTs3<-`yLtr`+-)GH%`zWI{> z+==OI$UaD8g6k6}-5!lF^rr;2HJ^Zz z7m!Yk4_jM|{BJRS7wgmlqj3+I(_e^;`Ut0Y_^#O$zx7I-_Se`E7An|$-B_vv^6iZmWgk`5bR1obK(N0;D(3{_igF|Go3!qw3{% z+1fPkAZ4Wwm2Ilr+Zchkl-S*aKpRr@akpeVqV`Hi0W92xMS7H%N~1PV*HX za?W4?scR3^G=^tat#u6E%_}(L#+B}+Uw8p9Sv5ro0zPuVg01n~()i1~Hz&9((01KY z-&LP{is1euLn{14qJQN-a8}Py%RrWrCk}&RA85LBFNd%l6zW^(XPzpha;@~{OoBHK zL!YMIVj}wigMReX!}%iEtK>yt;Y##E9{sx9VkY&~t3VyLPh8LLA&^7aU}dw&MY;kW zB63CrFzX!!l~7Q5-D7q03~|Dw2NNCUMOnJD<&5HvP`50tB4Zuxl-ypp&ZU}8OR~#u z^U@6KEF4le4_^T5GPuh5~F9~sH zwZ|?z!U{af#K9O1Y$_gfn(H0iD_Ofx;TyusF`bwW%8hE*yFs3k8^n!nIto|K)q@E; z+rt)6zXy%Z{Mt@L(8hJ~iHs7wzWIKgW_yh0+ zc2d?Rg>0HTZT6}^`uIKj(RIjZPF=CUvC`h0e*EEIXX(xMy;=dwkZ_qjGRskw&UU-R zQsH;<&*im~i}F#Q!|!xc=NYAOb302rqAA;~Z5XQ30%v@L)&tWv-w#L^brg0z!pNGg z>t7D?XN-ALmTARk_PJo~h?A?wTxTjZg!pMVoTox)cUk-|)S8iw+i`#Y{?Ib)yzjD9 z#3I*aA`BLCRv}wICGwiD_sd}5Fc~&g>;L>zP)L__CQyj+XGeDSO!XOZv&Z#&4zcI3 zZ*ILASGZEgR7@I{X2+=vmBy|(rLK#VC778Qm7&k@9<({}yx8s_{ZU6GK+b8^&i7N8 zF*sYLrmZaa6T%4pAid4yyEMV`n@LreXrTJquE@9O-}~*4Z)xhz%U@FC%jVed&c}xA zA30XzIFiw z?yWUmn`LNP^ZepxOL8WdKp!FO$4o1~-3KSfFNyU}exA=b%ze)7&*elaHgPB+UQ_H! zxm)uIU---1b@I`_Nv!+l%UE`z2bzGdeHOc1`@xQaWzC`7JX-zUXvmQ(y zm5vKbi;1a+#AJ+lFT7@F)k?L;qam9g4hyeca@ekN7)7vkCWC%;CsfigJ(^ChpvM~g zz+Z{#JSj{d+qT21F{3mCh+(Pf+@lx^*zprt?i?wd+FBI zYsOkQGVDs!T52m_dGdSz)r8YICuwG6+-WLE5?2iN)tnoi$=6aU-Eq~RA8w!gP+}vHUD>NX)d{8r7!pj~~dz`8{Y4(ET6C1Rc5f;Mo;*`>!y+E;8 zk%8S!_17*hhfRa?Bmx%sN|XJ~;z*s+FGV6}P9pt6ukdCliCi~jbrFaE{YUpvey-*S z!<^i8wXbIaOr`A{qW*>*zfq%gC_e0@8_(nA2GqlGg=sQV*Z(#t>!-f=sf?tOaMp+bdc2ruR^VztT&0Y5AN z#nXTAG)z0&{?2$Pw?_m|!&`F%UDE;QFV~|h-kXheeB)#jE4oA7vRL@CI? zwvp#97EdyS2#2uSLSjROUiIevu_<3oLi5+~=LT0B9EA1h|D>|RevuZ5ygeI~CdP>| z!>)$UZip4QOq1dr-HE1=fgZ>Zykw;y~=+yo)ZX_ z_J7fjwnFEIhN8Yp1uRB&Hv4PmXP`Mh%I(!A?G`Ioss8QuXtyS}IG~;tW&nv<`3+?` ztgejtAL}@U(2WCLUrXqW<|)r=+0gAzr$@B%sI!qK)G3J9NO`%605M!QPq5&?!yTu$C81QkfgazE~0irDZh z+zD!u+Q^`lB&})b55>I2AKYY=$mgXa6ws=NaXgUGD&VzZSjx+>X>sh_tE!dp6^l`6 z6Cbcq+(z*e2eEOi`3>O@wMjZkYmpQ+MW|LFY?v|#jmVbNnKDj@PRy+n10bzcGHyg( zxmKCFa_@I6%D*KEPCiTCBefHxa30+cs$%9y3pG6a+BgmwlGy%3c<|g|BJ{svkVihG z=tHoZMLuMB%zl>V3VYI$ua8V6kj>pf-zH4%OZ*m1PY+-SD1F4OI~f+#L?0~Cs!t84 zH|)Uj)7Pw6u_M3PM(@8G-*-3c_Ro9N`@Oc$mh(jSN}xdo7ipyj(y?kDG)AXFL3cP} zRD$ERZuR&xPJFK2L44DEBaF68OLxe(4$HlC4>+sB{08veCgdxsERZiPDp*~gCgpef zkeQabk(t!f5!sdE?{w#0b;ns7i8@Y5!+u5E1Q0y$X+zXln04z&$Z6YK)ex63i!;j$ zDllOa`hI3rL-Dp9CzkH8Kg-sFzmo`rRU0Aw31pj?e}MI%_|2x`RlDZ6r!Uy*?NDtU;b=8su~g?VEiFvF&Jw`z(xl2M;dz1eJ?F)?2j zyj{pK@A%X|I&iN<(Mg-9LEgDjKql3FC$AreiWwV8jiDL&Szne!%s;CQy}8BN~*CUtO>+c=hXh-Pv&s8YJ_ zW%$*_Ah%y@3kzdQ*<57o7Kc@19bTmvnpM&mW!}dCFNY~GUjIc#I*o9Y@w{`ZYU|S) zOsjt1jp!fnYhnW9XVIPn=sJ~spiber*a)BTd5ZB8xA5Mua0M@Y`kN3@hlD>Ct7m1X zv0}$&z1I`hKGxk_PFsDyza@y41}Fno=%Mq4Q`|SSHOsw4A6hUU!qj|=&7=I2Iy)V4 zUgW2YNc{&?%H%el2^3t;h)5{{w0ZT9jAa%ng2P4jM(;CMX?WXwO-HdwRLF%p);Y3%{!E3d$@CH2X93 zD6ygVWMBmfwb!qTz>oUsmiT!w;6?R2jyQ8FC*{3IG02)#dfdp*C3A9n2gO-0hnuXE zgeQ%nVtkNZ_a{9)Gv&5$FLP~g){705#))@^CGh9c^_R2B#(OkczXt!gd%;A`<-aQP zA2HEO&ec)5tWln22Oc^$Dy5&K`^>t$u&@y7=aFSwKCZc-DuKBtUAUz3|L>p7>#sT& Wd46B6a1-AD8Gux@l}i<^5dQ<(J8c>O literal 0 HcmV?d00001