====== offer-cube FAQ / Nachrichten an SLACK Channel schicken ======

Zurück zur [[offer-cube:howto|Anleitungen / HowTos]]

Siehe auch [[offer-cube:howto:syncsetting|Synchronisierungen]] \\
Siehe auch [[offer-cube:howto:syncsetting-hook-codes|Synchronisierungen Hook-Codes]] \\
Siehe auch [[offer-cube:howto:syscron|Zeitaktionen]] \\
Siehe auch [[offer-cube:howto:docmeta-email|Dokument Vorlagen f. Emails]] \\
Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] \\

Siehe auch [[offer-cube:faq:faq_ooi-syncsetting_notification_email_offer_accepted|FAQ: Email bei Angebotsbeauftragung oder Ablehnung]] \\


===== Allgemeines / Zusammenfassung =====

Das System kann Benachrichtigungen z.B. per Email (siehe [[offer-cube:howto:docmeta-email|Dokument Vorlagen f. Emails]]) über z.B. beauftrage [[offer-cube:howto:offer|Angebote]] oder versendete oder offene [[offer-cube:howto:invoice|Rechnungen]] senden. \\
Aber auch das Posten einer Nachricht in einen SLACK Channel ist möglich.

Der Auslöser für eine Benachrichtigung kann eine Aktion eines Benutzers sein (z.B. Angebot //Gewonnen// klicken) oder eine zeitlich gesteuerte Aktion wie z.B. 10 Tage nach Angebotsversand (siehe [[offer-cube:howto:syscron|Zeitaktionen]]).

Konfiguriert werden diese Art von Benachrichtigungen in einer [[offer-cube:howto:syncsetting|Synchronisierungen]] vom Typ //Hook//.

==== Details: Anlegen Hook ====

Unter "//Einstellungen//" --> "//Synchronisierungen//" wird eine neue Synchronisierungen vom Typ "//Hook//" angelegt.

==== Slack Channel Nachricht bei Angebot gewonnen ====

	* **Hook-Code:** global.offer.accepted
	* **Methodenname:** post
	* **Interne Konfiguration:**
<code>
{
"url": "https://slack.com/api/chat.postMessage",
"header": "Authorization: Bearer xoxb-6055533277079-6054649557773-NcYQSL1G9ove0NDUFOgq3ZMF",
"jsonheader": false,
"asjson": false,
"sslverify": false,
"post": 
	{
		"channel": "C012ABCXY0Z",
		"blocks": [
			{
				"type": "section",
				"text": {
					"type": "mrkdwn",
					"text": "[[$CONFIGURATION.ownCompany|escape]]: Angebot *[[$payload._objref]]* [[if $payload.summary != '']]'[[$payload.summary]]'[[/if]] beauftragt."
				}
			}
			,{
				"type": "section",
				"text": {
					"type": "mrkdwn",
					"text": "Kunde: [[if $payload.site_company]]*[[$payload.site_company]]*[[/if]] *[[$payload.site_name]]* \nAngebotssumme: *[[$obj.price_wdiscount|d2bCurrency]]* Euro netto inkl. Rabatt.\nAngebots-Ersteller: *[[$obj.created_user__firstname]] [[$obj.created_user__lastname]]* [[if $obj.annotation != '']] \n Interne Notizen:\n [[$obj.annotation]]_[[/if]]"
				}
			}
			,{
				"type": "section",
				"text": {
					"type": "mrkdwn",
					"text": "Link zum Angebot: [[myurl absolute=true noGetParams=true script='b']]#/detail/offer/[[$payload.id]]"
				}
			}
		]
	}
}
</code>

Hierbei werden wieder [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] verwendet, um die Inhalte aus dem Angebot in die Texte für die Slack-Nachricht zu übernehmen.

Folgende Informationen werden in den Slack Channel gepostet:

	* Angebotsnr und Angebots Titel
	* Kunde (Firma + Person)
	* Angebotssumme
	* wer das Angebot erstellt hat
	* direkten Link zum Angebot
	* sowie die Notizen, sofern welche eingetragen wurden.


{{offer-cube:faq:faq_ooi-syncsetting_notification_slack_channel:offer-cube-faq-syncsetting-slack-01-create.png|Einstellungen -> Neue Synchronisierung}}

{{offer-cube:faq:faq_ooi-syncsetting_notification_slack_channel:offer-cube-faq-syncsetting-slack-11-result.png|Ergebnis in SLACK}}