Tyntec portability check

certified-connectors/timeghost/apiProperties.json

@@ -84,7 +84,7 @@
         }
       }
     ],
-    "publisher": "Koellisch Gesellschaft für Prozessmanagement mbH",
-    "stackOwner": "Koellisch Gesellschaft für Prozessmanagement mbH"
+    "publisher": "Koellisch Gesellschaft fuer Prozessmanagement mbH",
+    "stackOwner": "Koellisch Gesellschaft fuer Prozessmanagement mbH"
   }
 }

certified-connectors/tyntec Portability Check/README.md

@@ -0,0 +1,43 @@
+## Tyntec Portability Check
+
+Adds the ability to check phone numbers against the tyntec number portability database to validate phone numbers. It can be used to increase conversion, improve phone number data mining, and reduce fraudulent SIM swaps attempts.
+
+
+### Use Cases of this connector
+- Validating Contact Phone numbers
+- Mining more data on your Contact
+- Understanding if you should use the SMS channel with the Contact
+- Fraud Prevention (detect SIM swaps)
+And many more!
+
+
+## Pre-requisites
+You will need the following to proceed:
+- A Microsoft Power Apps or Power Automate plan with custom connector feature
+- [tyntec API Key](http://my.tyntec.com/api-settings)
+
+## Supported requests
+- **CheckPhoneNumber** using tyntec Portability Check API [reference](https://api.tyntec.com/reference/#number-information-global-number-portability)
+    - To make a successful request, please, populate the followings fields:
+        - *msisdn* - The Phone Number you want to check
+
+## Interpreting received values
+- "requestId": The ID of your request
+- "msisdn": The phone number of interest, given in the international format
+- "ported": An indication of the porting status (True/False)
+- "errorCode": The reason for an unsuccessful attempt (if 'ffff' then the phone number doesn't exist)
+- "mcc": A representative MCC (Mobile Country Code) of the operator
+- "mnc": A representative MNC (Mobile Network Code) of the operator
+- "ttId": The respective tyntec ID of the network
+- "operator": The operator's name
+- "country": Country of its operator 
+- "timeZone": Timezone of the given Phone number
+- "technology": The technology used by the operator's network. Possible values are: GSM, MVNO GSM, GSM/CDMA, Satellite, CDMA, iDen, iDen/GSM, Pager, Fixed
+- "synchronous": true
+
+## How to get API key 
+Please [sign up for a free account](https://www.tyntec.com/create-account). In your account, select the [API settings](http://my.tyntec.com/api-settings) and copy your API key.
+
+## Deployment instructions
+Please use [these instructions](https://docs.microsoft.com/en-us/connectors/custom-connectors/paconn-cli) to deploy this connector as a custom connector in Microsoft Power Automate and Power Apps.
+

certified-connectors/tyntec Portability Check/apiDefinition.swagger.json

@@ -0,0 +1,140 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "tyntec Portability Check",
+    "description": "tyntec Portability Check allows you to validate a phone number in the tyntec number portability database",
+    "contact": {
+      "name": "tyntec support",
+      "url": "https://www.tyntec.com/get-help-support",
+      "email": "support@tyntec.com"
+    },
+    "version": "1.0"
+  },
+  "host": "api.tyntec.com",
+  "basePath": "/",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [],
+  "produces": [],
+  "paths": {
+    "/nis/v1/gnp": {
+      "get": {
+        "responses": {
+          "200": {
+            "description": "default",
+            "schema": {
+              "type": "object",
+              "properties": {
+                "requestId": {
+                  "type": "string",
+                  "description": "requestId"
+                },
+                "msisdn": {
+                  "type": "string",
+                  "description": "msisdn"
+                },
+                "ported": {
+                  "type": "string",
+                  "description": "ported"
+                },
+                "errorCode": {
+                  "type": "string",
+                  "description": "errorCode"
+                },
+                "mcc": {
+                  "type": "string",
+                  "description": "mcc"
+                },
+                "mnc": {
+                  "type": "string",
+                  "description": "mnc"
+                },
+                "ttId": {
+                  "type": "string",
+                  "description": "ttId"
+                },
+                "operator": {
+                  "type": "string",
+                  "description": "operator"
+                },
+                "country": {
+                  "type": "string",
+                  "description": "country"
+                },
+                "timeZone": {
+                  "type": "string",
+                  "description": "timeZone"
+                },
+                "technology": {
+                  "type": "string",
+                  "description": "technology"
+                },
+                "synchronous": {
+                  "type": "boolean",
+                  "description": "synchronous",
+                  "x-ms-visibility": "internal"
+                }
+              }
+            }
+          },
+          "400":{
+            "description":"Bad request - Check if msisdn is numeric"
+          },
+          "401":{
+            "description":"Unauthorized - Invalid account credentials"
+          },
+          "402":{
+            "description":"Payment Required - The current credit balance is not sufficient for this request"
+          },
+          "403":{
+            "description":"Forbidden - Authorization information is missing"
+          },
+          "500":{
+            "description":"Internal Service Error"
+          }
+        },
+        "operationId": "CheckPhoneNumber",
+        "summary": "Check Phone number using the Portability Check",
+        "parameters": [
+          {
+            "name": "msisdn",
+            "in": "query",
+            "required": true,
+            "type": "string",
+            "x-ms-summary": "Checked Phone number",
+            "description": "Checked Phone numbe",
+            "x-ms-visibility": "important"
+          }
+        ],
+        "description": "This Action get Portability Check data for a given phone number"
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {},
+  "responses": {},
+  "securityDefinitions": {
+    "api_key": {
+      "type": "apiKey",
+      "in": "header",
+      "name": "apikey"
+    }
+  },
+  "security": [],
+  "tags": [],
+  "x-ms-connector-metadata": [
+    {
+      "propertyName": "Website",
+      "propertyValue": "https://www.tyntec.com"
+    },
+    {
+      "propertyName": "Privacy policy",
+      "propertyValue": "https://www.tyntec.com/data-privacy-statement"
+    },
+    {
+      "propertyName": "Categories",
+      "propertyValue": "Communication;Marketing"
+    }
+  ]
+}

certified-connectors/tyntec Portability Check/apiProperties.json

@@ -0,0 +1,23 @@
+{
+  "properties": {
+    "connectionParameters": {
+      "api_key": {
+        "type": "securestring",
+        "uiDefinition": {
+          "displayName": "apikey",
+          "description": "The apikey for this api",
+          "tooltip": "Provide your apikey",
+          "constraints": {
+            "tabIndex": 2,
+            "clearText": false,
+            "required": "true"
+          }
+        }
+      }
+    },
+    "iconBrandColor": "#F8981D",
+    "capabilities": [],
+    "publisher": "tyntec GmbH",
+    "stackOwner": "tyntec GmbH"
+  }
+}