en:how_to_create_an_interface

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:how_to_create_an_interface [2024/11/07 11:50] – [Menu item Form] bken:how_to_create_an_interface [2025/04/01 10:51] (current) – [How do I create an interface?] bk
Line 1: Line 1:
 ======  How do I create an interface? ====== ======  How do I create an interface? ======
  
-For a newsletter, new addresses are generally obtained automatically, e.g. via the company website. When using REST you will find the interfaces under //Addresses > Interfaces//.+For a newsletter, new addresses are generally obtained automatically, e.g.via the company website. When using RESTyou will find the interfaces under //Addresses > Interfaces//.
  
-<WRAP round tip 80%> 
-If you use SOAP, you will find all address interfaces under //Addresses > Generation// To do this, read the step-by-step instructions in the article "//[[en:how_to_create_a_new_adress_generation]]//". 
-</WRAP> 
  
 ==== Creation of an interface ==== ==== Creation of an interface ====
  
-Via //Addresses > Interfaces// you can create a new interface with this button:+Via //Addresses > Interfaces//you can create a new interface with this button:
  
 {{:en:addresses_interfaces_button.png?nolink&150|}} {{:en:addresses_interfaces_button.png?nolink&150|}}
  
  
-The following window opens via //Create interface//, in which you assign a name, select the channel (E-mail, App Push, SMS, Print, Web Push, Voice), the opt-in type (Double opt-in, Single opt-in) and configure hooks. You can also enter a URL for redirects.+The following window opens via //Create interface//, in which you assign a name, select the channel (E-mail, App Push, SMS, Print, Web Push, Voice), the opt-in type (Double opt-in, Single opt-in)and configure hooks. You can also enter a URL for redirects.
  
 {{:en:addresses_interfaces.png?nolink&600|}} \\ Now the interface has been created and provided with an ID. {{:en:addresses_interfaces.png?nolink&600|}} \\ Now the interface has been created and provided with an ID.
  
-==== Menue item Sheet ====+==== Menu item Sheet ====
  
 === Configure hooks === === Configure hooks ===
  
  
-Under //Add hook// you can define which //Action// should be carried out with the generated address. First choose between the following actions: \\+Under //Add hook//you can define which //Action// should be carried out with the generated address. Firstchoose between the following actions: \\
 \\ \\
 {{:en:addresses_interfaces_hook.png?nolink&250|}} {{:en:addresses_interfaces_hook.png?nolink&250|}}
Line 32: Line 29:
  
  
-After a successful or failed login, you can be redirected to any page. To do this, enter a URL, e.g. a confirmation page on your company website.+After a successful or failed login, you can be redirected to any page. To do this, enter a URL, e.g.a confirmation page on your company website.
  
-You can specify a URL including a protocol for forwarding if the login was successful. Appending parameters is possible to personalize the landing page. +You can specify a URLincluding a protocol for forwardingif the login was successful. Appending parameters is possible to personalize the landing page. You can also enter a URLincluding a log for forwardingin the event of a failed login.
-You can also enter a URL including a log for forwarding in the event of a failed login.+
  
  
 === Copy interfaces === === Copy interfaces ===
  
-At the top right of the interface you have the option of copying the created interface with all the associated settings.+At the top right of the interfaceyou have the option of copying the created interface with all the associated settings.
  
 {{:de:addresses_interfaces_copy.png?nolink&100|}} {{:de:addresses_interfaces_copy.png?nolink&100|}}
  
- +==== Menu item Log ====
-==== Menue item Log ====+
  
 Here you will find a list of user actions: Here you will find a list of user actions:
Line 56: Line 51:
 | Message | Comment entered via API (optional) | | Message | Comment entered via API (optional) |
  
- +==== Menu item Statistics ====
-==== menue item Statistics ====+
  
 Above you will find the following two statistics: Above you will find the following two statistics:
  
-Registrations Number of registered logins. In the case of double optin procedures, regardless of whether the registration was confirmed by double optin. \\ +RegistrationsNumber of registered logins. In the case of double opt-in procedures, regardless of whether the registration was confirmed by double opt-in. \\ 
-Confirmations Number of registered registrations whose e-mail address was not included in the master data before registration. +ConfirmationsNumber of registered registrations whose e-mail address was not included in the master data before registration.
  
 Below you will find the openings and clicks on the DOI Mail. Below you will find the openings and clicks on the DOI Mail.
Line 69: Line 63:
  
  
-==== menue item DOI campaign ====+==== Menu item DOI campaign ====
  
 This tab only appears if //Email// was selected as the channel and //Double Opt-In// was selected as the opt-in type. This tab only appears if //Email// was selected as the channel and //Double Opt-In// was selected as the opt-in type.
Line 75: Line 69:
 You can create one or more messages. The message that is to be used for the DOI Mail must be activated. You can create one or more messages. The message that is to be used for the DOI Mail must be activated.
  
-The available messages are displayed in a list. (Maximum) one message is active. The active one is used for delivery. It cannot be edited. To change the active message, you can copy it and edit the copyor create a new one. Activating the message created in this way will deactivate the previously active message.+The available messages are displayed in a list. (Maximum) one message is active. The active one is used for delivery. It cannot be edited. To change the active message, you can copy it and edit the copy or create a new one. Activating the message created in this way will deactivate the previously active message.
  
 === Creating a double opt-in email  === === Creating a double opt-in email  ===
Line 81: Line 75:
 Don't forget to configure sender and subject too! Don't forget to configure sender and subject too!
  
-You can use $confirmToken which contains the opt-in confirmation token. This token can be used to confirm an opt-in via REST API +You can use $confirmTokenwhich contains the opt-in confirmation token. This token can be used to confirm an opt-in via REST APIThis placeholder is not replaced in the preview of this mail and is only available when the double opt-in mail is actually sent.
-This placeholder is not replaced in the preview of this mail and only available when the double opt-in mail is actually sent+
  
 Example URL: Example URL:
Line 94: Line 87:
  
 <WRAP round tip 80%> <WRAP round tip 80%>
-The form creation is only possible in clients with the mail-unique identification feature (not for custID-unique). It is only available for the "E-Mailchannel. +The form creation is only possible in clients with the mail-unique identification feature (not for custID-unique). It is only available for the E-Mail” channel.
 </WRAP> </WRAP>
  
-Under this menu item you can configure a form for address generation that you can +Under this menu itemyou can configure a form for address generation that you can embed on a website or call up as a stand-alone page.
-embed on a website or call up as a stand-alone page.+
  
 === Content tab === === Content tab ===
  
-In the //Content// tab you can select the fields that your form should contain.+In the //Content// tabyou can select the fields that your form should contain.
  
 {{:en:addresses_interfaces_formular_content.png?nolink&400|}} {{:en:addresses_interfaces_formular_content.png?nolink&400|}}
Line 127: Line 118:
  
 <WRAP round info 80%> <WRAP round info 80%>
-Our system does not support placeholders on the confirmation page, e.g. for a personalized greeting.+Our system does not support placeholders on the confirmation page, e.g.for a personalized greeting.
 </WRAP> </WRAP>
  
 === Design tab === === Design tab ===
  
-Set the font, font size, font color and the primary color of the button. You can optionally insert a custom CSS.+Set the font, font size, font colorand primary color of the button. You can optionally insert a custom CSS.
  
 {{:en:addresses_interfaces_formular_design.png?nolink&400|}} {{:en:addresses_interfaces_formular_design.png?nolink&400|}}
Line 154: Line 145:
 === Usage tab === === Usage tab ===
  
-Copy the code of the created form to embed it on a web page or copy the code for a standalone page.+Copy the code of the created form to embed it on a web page or copy the code for a stand-alone page.
  
 {{:en:addresses_interfaces_formular_usage.png?nolink&400|}} {{:en:addresses_interfaces_formular_usage.png?nolink&400|}}
en/how_to_create_an_interface.1730976642.txt.gz · Last modified: 2024/11/07 11:50 by bk