From db460c26fb8af198bfb4f93f6ea1c65862cc11c2 Mon Sep 17 00:00:00 2001 From: Bendik Brenne Date: Sun, 20 Oct 2019 15:20:09 +0200 Subject: [PATCH] Add sinch component (#10384) * Added sinch component (home-assistant/home-assistant#26502) * Update source/_components/sinch.markdown Co-Authored-By: Franck Nijhof * Minor fixes after review * :pencil2: Tweak Co-authored-by: Klaas Schoute --- source/_components/sinch.markdown | 65 +++++++++++++++++++++++ source/images/supported_brands/sinch.png | Bin 0 -> 5884 bytes 2 files changed, 65 insertions(+) create mode 100644 source/_components/sinch.markdown create mode 100644 source/images/supported_brands/sinch.png diff --git a/source/_components/sinch.markdown b/source/_components/sinch.markdown new file mode 100644 index 00000000000..d1c8c2e07a4 --- /dev/null +++ b/source/_components/sinch.markdown @@ -0,0 +1,65 @@ +--- +title: "Sinch SMS" +description: "Instructions on how to add Sinch notifications to Home Assistant." +logo: sinch.png +ha_category: + - Notifications +ha_release: 0.100 +--- + +The `sinch` platform uses [Sinch](https://www.sinch.com/products/messaging/sms/) to deliver notifications from Home Assistant. + +## Prerequisites + +Go to your [Sinch Dashboard](https://dashboard.sinch.com/sms/api/rest) and click "Add new REST API". You should now be able to obtain your `service_plan_id` and `api_key`. + +## Configuration + +To add Sinch to your installation, add the following to your Home Assistant `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +notify: + - platform: sinch + service_plan_id: SINCH_SERVICE_PLAN_ID + api_key: SINCH_API_KEY +``` + +{% configuration %} +name: + description: "Setting the optional parameter name allows multiple notifiers to be created. The default value is `Sinch`. The notifier will bind to the service `notify.NOTIFIER_NAME`." + required: false + type: string +service_plan_id: + description: Your Sinch Service Plan ID. + required: true + type: string +api_key: + description: Your API Token. + required: true + type: string +default_recipient: + description: "A single or multiple phone numbers. This is where you want to send your SMS notification messages by default (when not specifying `target` in the service call), e.g., `09171234567` or `[09171234567, 09177654321]`." + required: false + type: [string, list] +sender: + description: The name or number of the sender. + required: false + type: string + default: 'Home Assistant' +{% endconfiguration %} + +To use notifications, please see the [getting started with automation page](/getting-started/automation/). + +### Full configuration example + +```yaml +# Example configuration.yaml entry +notify: + - platform: sinch + name: Sinch + service_plan_id: SINCH_SERVICE_PLAN_ID + api_key: SINCH_API_KEY + default_recipient: [PHONE_NO1, PHONE_NO2] + sender: Home assistant +``` diff --git a/source/images/supported_brands/sinch.png b/source/images/supported_brands/sinch.png new file mode 100644 index 0000000000000000000000000000000000000000..53a28454eac86234c66c10df2bdf69f0466c1768 GIT binary patch literal 5884 zcmV(_`g8%^e{{R4h=l}px2mk>USO5SzmjD14Z`WEM zkN^M{f=NU{RCwC#oqL>AW&OwBXJ(dV@4L7xEGvs97ZH^dE7M3cGEGy9&?wVLO-VCv zCFL(QMbWadi`LJ~A8Gk31?eIs1co;PF)k8!P%d&;*c-d-&dfRe@%=80yK~N*b7p3* z=kt2a3wGw5=RD^*&*wbf`(s#^MSuVSk|PuhL4W`OK>`E_2ofMbK#%|d0)hkx5D+9l zfPf$Y0t5sJ5Fj8(fB?M@5rEUio$u@9SRD2rG?{sGF&{p?54>x3=Dkz{w*qy*LqM&M zHf{or1D*tycG{if8MM@!e0q8vZ|^fHD=>nY+6j1L;opTIJpcv3pMekR-=6^f2YAut z`6mGP0-w{rF9SXdYzd}GAY%0dd?tY$03QVw0Kd}}!S-DZ+z+fyAO}Ey;JRRX1n4OQ zdB^7aF992XyMdfGzg-S&0={E&?&e^61n4OQc@_Ac!#&=mWVjgk5bzT46fnrg!?2DAV>f%U)} z`bmcW0G9w40N)43xV+|GJ^s-Y#~q{k%?ZE|pa^ILwgYbhFFS~P0Rn=gg;HQDa3wG> z#j)#wKd2a#Y(mb_&mRzrloK8X?gZ)`j=3E8DsXm+w&K8S;6Vox2M9zg&-jw+2)DZ+ z2fzr`E8YTr1oUh3dol38x)RypufS;FW(RUysbqZ01vvo1z~>Pk%8!ES6%Zs7_#R@8 zJ<7+qIlwJSuCMEN0}-?B*AR1UTdV~>3tXgPQ8Jtk{1cb~4EK3ow;-nG0D*|*8@B-W z*!M|33`0#qeArV%ms{?MU6{eb&O?E~4Zt5-cx2n+=VBsuOJ zU_LNDm}&t*ykfMC7_tlTYR^*TIT6Ew3xR8Z|?;Q zz+xbp@LM0m`gLm(QS1|H0JtldZh?s91y3jW?r*AJ{4xnSK%9O*21cp~wLQf(UINA{ zq3p=pIi5X5#;p3vsIrHFa9-enuV zR?+4@;6R(-wgX=V#vx9`WEg^2x#nSS4qgD92HXJbaM`c>N$#`^R*--ou5ne8?=JDt zP74y0cy+>e_o}Y)JBRb`1U6!C0^W|8cEYsJQYCOGq$AJ4Lf4wBgs>5 zBG#{DSfjsv7V(i}3hyB%>O_=!8CN67lj`0CF@Sg+;-=;0X~vR#*C$JQ&L+h4nhZ_A zw}4R@Si$VZwyhXvdKufGY;rdzNGJqNEwHcN^5Rk1rOI_8j?dsdoe3;Nd>@rI$IMWD zT+9r#fK&|h_D~JKjF^ly(wJmH|AA|C+TPgdO zNxqwfyGY(doDVEVLRN}wj`^92Q;#_)@(%*5+9>i9lq6sCF)V*gqLBZ>)tQ9`?2Yr> zl4klB_qwV~24Y3rkRVm;>DC146M?2?`02bRY0cd#vIa4$wzcrAa1f6YaSGx)`5W&q z){ux+5BWEN8k=LT)Q9nHo8PODu=&NfZt5ih!3IQt$Ig{F|apu;Kp0dXcaARh8u zhko6ooQMFOnRt}ck4|?3NK)D4Iv$O~G5td{oACMj>bPNAEt@vSpgIgC zAt&X1KH{vK>*KO71Lx^#V^_!O6G*_}&#?Dv{9OC6QU7iLZbL#(p7znNw~!J;ce^5o zY4OFoYM8yeg_Ekom?k|Px8fnHphpm-l_Ud8LsXQ7nDLJ$&i!r;cmJZEhI$i@2}6!y zN0hg8qFQY)~uMS^9Az)@UW*sW!jQMFI$KBzgSRS|m$xq^<@_9o9or#lUX@7LMe?dqp+kGdWt7^d=-%WF_M3 zNDfOislpKC8IWrb-xuf0(`uRZMwHP*!o7tY=*#0XE{{FY<1^0~vRb@4ZbDICgHw); zu;YNqS01Y4`Nhpl|7sys!y~ZEgl5Zb4XZx#&#joAWXCRCP&s3;CGdvObk)*RsOD+;*$ zl6*L5!G1HFX+((v-E73Wy`e)!wIBpV1~gc#+Yn{$@+dE_jrcu@)#TG8j=A zCT<4g=#>OHJWDm$cT{zlJvA2BJY3JeR!8~y^+klL!mu-*t<01P)o*T7f}|;sCTMOU zL;j8ceGCzwB8JTLdXuf&V!XO8#tX|^_}7{ib|0`P$}=c0HuykA_;Bc2%nT-BuO~<= zVsYqSY*1Pd;qm#0Sp9a4C#RNBJu(8@NOhq`FQjjU%pY=0M%9I6L>7yjO2h+i0=>phe9=liGt8 zHH{Vrn=NV^^54Zs*piW1aiWV6EVomf&N7y!X@qRGeAHP--yPcvMfYNzQqq_HnMbWl!vY>pYU7C_;TrEDK7)07la87|Bm^~$7F+km`RIrozBMtQ^FNl$s&z3Qc&3r( zmo!sUU{KXBWJ`<$gpr(%=aF#p!-j%`%@z$!7LCmo1$_-721IfU29!uVnM>s9y^liD zYs-MXs?9VYNm`qb5dOEj=tLc^6YvB2{EAenh$7jPyY$(uBzdLFjv&ZM$i6R$C`C3| zJrRkwxO9@vM346RfPW?BUCBVwJd6Yo6jpj+%lN_@^iOs?$`VPYl}crf?5r^vIw(vyBu>Z__!JV3GFT_=5fX->B;TMU-#EO=SeED$F33@c zgyCO;WI>j@y!SVe{FGTpZb@h2Vx+SDSlow~HzSE@^N=09mUUo%6P>-6BgOvCB6R>O zND|yXblewZTf{mWsbY9e25!0ucmj!>-JR@!kRcQHy*iVke1pQih8toG10LYWj8~Iyx>BE`FT9~?^m!qY zIr@T^6~v8uE=MQxiy0zEt9Wv~iXcfto=r>QxhhIS8Ojy}M2#7q9UHmXRvXx$C> zdl?`{>x*VCk`z|a0pz$s`~P5u$kBQaf6=$|2ea7s#)Rt(O|z|Wz~6N>sdRf%DuN7E z`EPQT2A}{5HJ^!dUWF6BqB7^yEc9;%Qnhhl7TTVu^8JNb8rwXiIQMT=)XWCPtLSxm zmfA0+efn~`_?(XWMd=dc1Qk(+lYLB3rOL}hJX4qY|3e~dGl^nk$J;BjeBWg%rd*%l zc8^o}`!YHP58y9vrn6A2y3{xQ5~K*JAyv?UogSftOhuBu9I1abE(`rA)VJb?JMi9r zk--&kw7zVP>)=T@2}xkRvEC1ETB@ z#7b7sNfU0Y%K6<1)75z4njq)nZbw%;rK%y#4!4kezrR+*an4~+2hY*D71*D^KKn5h z`T(!d#;n~5I1l@hu3Z(svXdA>HjMIu1!^f7iDcPT>6`3qWUr1@F58JCduo)Z)uN+u z1ybR?voQ~U*0HKRng2Z79xI` z{~)`3HLIbb8YyUT0TNE*6)W*y+t|&xKc~{mW{%WOtJHD7*yp%ki&*5g*b&4_=*XiU zFTM=1IxSW`<7OXiWCNv6N}2;^=!&=9!O-!2#NY8_+V85B3ilvBo>Z8MKOfR_$Ofo( zVIxbB9l35t!fWoqU8VJ%h*R~6EIqH^0pE2P_rGXgC+N6)bphP3D{@j1tJFh7O+IdJ z2@+y3qKl9N;Hy5)xeDhk6cX{QPOMivUgOL9CU-&v*#yXszBK{&F;z1Wzu4n0R^p*q zB*)iuT-=QNETov=LXX#&l*ofn5=Gf9Zt{7P&y)U^YnfKgz2JHu6QBX9=eyCvIUyAl zoG=0JCf&1D=ktSWY+h`CMXY~QeZDx|;AUj&Z!c)l`(5Mlya{#$dDlZD6IIOUas`Jy zV30?n#G*7;zKc8_pDGOHa*ypz_VGqd_JU{)KVPrn*G04sNzWvf_%K|gGwz>m+oAXQrFlmUeXs@ro__wRfL(<0nh2S zG|%6xI+t6FY1PNu62z|;^y6xES%FkPoB>>ogqrv1!UQ?l!?ADSb_+FU{M5s-RSwGi z7>~;NlnjpBQpEb$5!i-=6{U+uJRCbj=WaVI)>gz6duAFPIbJ`lfquJniCm;Nx`fX0 zbtHqADA!Ewg!?k$D=PNT$9K{s_i{43#dSyGg$%Xx3P-l9aD(b(D+s{XGkk*sRoQ${ z$+uNkn6BX1D)Vsc8yUK09LX?ri=%A5AK{^m*>qq0J45Y6JwC%SJA%9kd?$-HT&1ha z998VD?!>|O61TJ?!(xM5*jcG6I$@G^2HwhGTbn%`n`cK55O3nc9dPrb5Yydj_z%+S zC}h%nS?}RkySS_(4{hx1#soRond9yhUU4%L^3V}DL*H_fI(YD{3`|r%Ff!1`NGFlI zqtU73o+|#Rb?2oy9W)qEli;KY9+V@zRPTxe1o79Fn*hBvh{I|;lH+_R%L6hK**GUa z=2nG%!EpJ5mk8DcDgqsYY->CNiD1nZNdh=yzlURw4~8rI1Zl+{WKZkKNSMhOB#7)W z#EjOEfqtEeI3EMpV~dAlKNSp@KV(8SU8bL3CoJbDAt{VwfphT}j(r8)uLwX#!b|Ma zh58JdgJH}53gTwze+fyZx=2N`o3N>%=ztFekH-;SoL;%4+OORka_D|>cU^`cZLu4P zKN^9AJh;Umy0`Tu+js}}`Tiiz-%M3&xdVy2djxw=f3G9RB+?6btHWEloqw5v&Api*)riIFX(SgSoi~P;uz}Xy00Y>=YoUo_kzmmQKCd^H z_K~$^NNVc}yysnXYl0X^KJo_MUxIUP8rSn;Zrl&l1RQY0cDzTsjzRK%yhJVZLGr*~ z#y);+G?MEw8*jA@x+Os_L$bvlpuGiZjFQBUhw}#>j@=l{e^zq|Yl1%<-NOe3XoQs$lZ}sp7`wiZF8}oy??+R;x zC-I(J4^r0WH2wc>WEZI@lC4;orVcnob)*eFfgm4Mh09Bh^9e`>;zC_oU(+SO1_|_P zt*tZ;DXTNWW8a<%=DurOjZ}p!N~4W|WVX=Tqe#859o8%6b&BR#`|M zgWtkof5u&DmjFk`{Q|m_zd6*zeK7Eb{0$|w`XThBnU`6)oq>FpJ{>akv8rkdt0J8 z;XRc?R`jI7OlIc&5!v5*EE(=VYPtqUA3p#trQ?DVUqce>miM%QwDW^JiB!pctpob7 z1Bo`hKbY4UMQcsqzh&_nab#=okM&fs*vXT=Qg3_;*>T!6>YHvD-cowQxUWW%YC{<> zAs3n4xyj3R(&=oc_BLYOx-1K#&u{hF-RI-n&KmclydLW&TJ~4^nE-qVG3l12(aBZ7 z?~yp7y*|!wMm89AlVg&~N%fk(B-|8lcsGL&Y8jFS;O4sTWZ-(w=;uPDZ0LCW`ApU$ z&c7L?mrc3|v3Pd$xUWF`cW$n`9Kf(Fi_^w=**Awm;3F!6jYLAI%aKZf`3V!Q8K_kf ztk)H3k^UQ?b5Vu_9-fMXnN%Z*ZiV{%Vn~Ucz50?_hV1LIv^NdX8w>x=e+K}t>C+E7 S4*6yP0000