Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Salesmanago integration provides the ability to send data to Salesmanago. The following sets of data and actions are currently enabled:

  • Upserting Salesmanago contact - creates or updates a contact in Salesmanago

  • Deleting Salesmanago contact - deletes a contact in Salesmanago

  • Creating Salesmanago external event - creates an external event in Salesmanago

  • Creating Salesmanago Product - adds a product to the product feed

  • Get information about a contact in

    salesmanago

    Salesmanago

To activate this integration for your account, contact our team and provide a mapping for the data you will send and the fields you want to use in the integration. The fields will be mapped to Salesmanago fields.

Upserting Salesmanago contact

This integration allows you to create or update an existing contact in Salesmanago. The fields presented are the most common ones, some additional fields are available.

Endpoint

Code Block
[POST] https://api.datatalks.se/v1/contacts

deprecated: [POST] https://htpfdjhk3h.execute-api.eu-west-1.amazonaws.com/Production/contacts

Available fields

Code Block
languagejs
{
	data: {
		email: String,
		fax: String,
		name: String,
		phone: String,
		company: String,
		streetAddress: String,
		zipCode: String,
		city: String,
		country: String		
	},
   	group_key: String
}

Deleting Salesmanago contact

This integration deletes a contact in Salesmanago.

Endpoint

[DELETE] https://htpfdjhk3h.execute-api.eu-west-1.amazonaws.com/Production/contacts

Available fields

Code Block
languagejs
{
	email    data: {
        email: String
    },
    group_key: String
}

Creating Salesmanago event

This integration creates an event in Salesmanago. Up to 20 details can be added to an event.

Endpoint

Code Block
[POST] https://api.datatalks.se/v1/events

deprecated: [POST] https://htpfdjhk3h.execute-api.eu-west-1.amazonaws.com/Production/events

Available fields

Code Block
languagejs
{
data:{
	email : String,
	description: String,
	products: String,
	location: String,
	value: Float,
	contactExtEventType: [PURCHASE, CART, VISIT, PHONE_CALL, OTHER, RESERVATION, CANCELLED, ACTIVATION, MEETING, OFFER, DOWNLOAD, LOGIN, TRANSACTION],
	externalId: String,
	shopDomain: String,
	detail1: String,
	detail2: String,
	detail3: String,
	detail4: String,
	detail5: String,
	detail6: String,
	detail7: String,
	detail8: String,
	detail9: String,
	detail10: String
},
group_key: String
}

...

This integration sets the products on the salesmango Salesmanago feed

Endpoint

Code Block
[POST] https://api.datatalks.se/v1/products

deprecated: [POST] https://htpfdjhk3h.execute-api.eu-west-1.amazonaws.com/Production/products

Fields marked as * are required.

...

Code Block
languagejs
{
data:[
	{
		id*: String (32),
		name*: String(100),
		description*: String(1024),
		category*: String(255),
		sub_category: String(512),
		brand*:String(512),
		sex: Integer,
		price: Decimal,
		special_price: Decimal,
        detail1:String(512),
        detail2:String(512),
        detail3:String(512),
        detail4:String(512),
        detail5:String(512),
        url*: String(512),
        image_url*: String(512),
        image2_url: String(128),
		stock_available: Integer,
		color: String(40),
		season: String(40),
		<any field>: <any value>
	}	
],
group_key: String
}

Get information about a

...

Salesmanago contact

This integration gets data from a salesmanago Salesmanago contact

Endpoint

[GET] https://htpfdjhk3h.execute-api.eu-west-1.amazonaws.com/Production/contact/sm_id

Available fields

Code Block
languagejs
{
    data: {
        email: String
    },
    group_key: String
}


You can also get contact by EMAIL:

Endpoint

[GET] 

https://api.datatalks.se/v1/contact_by_email?email=EMAIL_HERE

(no payload required, just an email as a query parameter)


or by ID:

Endpoint

[GET]

https://api.datatalks.se/v1/contact_by_id?id=ID_HERE