As Khoros Flow already supports system entities system.email or system.date, Flow Code Action also extends these system entities with location-based entities such as addresses or postal codes for the developers to trigger the address prompt or choose a location during a conversation.
Implementing the System Entities
Parameter data format
Any extracted system entity should comply with the Flow param format.
Example of an extracted system.address entity:
{
"your_param_name": {
"address": [
{
"value": "1 Infinite Loop, Cupertino, CA 95014, USA",
"type": "system.address",
"match": "1 Infinte loop, USA",
"address": {
"streetnumber": "1",
"street": "Infinite Loop",
"city": "Cupertino",
"statecode": "95014",
"postalcode": "2083",
"area": "Santa Clara County",
"state": "California",
"country": "United States",
"countrycode": "US"
},
"coordinates": {
"lat": 37.3318641,
"lng": -122.0302537
}
}
]
}
}
If the address service matches with (for example, if the name John Dow matches for email, number, date, etc) the data is added as a param.
- match: The text that was converted
- value: Formatted address string
- location: Object with optional metadata
System entity for address
The system.address entity verifies the address of the users by matching the user location stored in the system.
Data format
Example of the data format for address:
{
"params": {
"address": [
{
"value": "1 Infinite Loop, Cupertino, CA 95014, USA",
"type": "system.address",
"match": "1 Infinte loop, USA",
"location": {
"streetNumber": "1",
"street": "Infinite Loop",
"city": "Cupertino",
"postalCode": "95014",
"postalcodeSuffix": "2083",
"area": "Santa Clara County",
"state": "California",
"stateCode": "CA",
"country": "United States",
"countryCode": "US"
},
"coordinates": {
"lat": 37.3318641,
"lng": -122.0302537
}
}
]
}
}
Access Addition Parameter
The following parameters can be used for matching the address and postal codes with the system:
Country: {{myParam[0].address.country}}
Postalcode: {{myParam[0].address.postalcode}}
