Why should you need this Studio Action Card ?

Sometimes the telephone number used (or provided in spoken form) by callers needs to be known in order to initiate next actions such as:

• sending a text message
• enter a number for a callback
• support calls from only certain countries, or line types (mobile, fixed, etc.)

How to use it ?

Before using the caller's number, you want to check that it matches your expectations, so you need to insert the Studio Action "Check Phone Number Type" in your script:

1. insert Studio Action Check Phone Number Type and fill-in parameters:
   1. Countries parameter: fill-in or not
      1. if you only want to process numbers used in certain countries, then select these countries in the dropdown, or you can all —> example in screenshot: only French, New Caledonian and Reunion Island numbers
      2. or you can also choose not to eliminate countries and thus process all phone numbers
   2. Context key to check parameter: fill-in or not
      1. if you want to use the parsed or recognized number (orally, retrieved by an API, or other ...) --> you must fill in the desired context key (only the text in camelCase)
      2. if you want to use the number with which the caller is calling --> leave the field empty and the action will use the number found in the meta.headers
2. when exiting the Studio Action Card, the number is then classified, according to the criteria entered in the card's parameters, and the script can then be designed using several context keys:
   1. isInvalidPhoneNumber : if the type of number is not recognized, or if the type of number recognized does not correspond to the accepted countries
   2. isFixedLinePhoneNumber : if the number type is a fixed number that corresponds to one of the selected countries (if any, otherwise all fixed numbers)
   3. isMobilePhoneNumber : if the number type is a mobile number that corresponds to one of the selected countries (if any, otherwise all mobile numbers)
   4. isOtherPhoneNumber : if the type of number is neither a fixed nor a mobile number, but is not "prohibited" and if it corresponds to one of the selected countries (if any) —> in this case, we can have special numbers, malicious numbers or advertisements for example

Interface Contract resume:

Inputs:

• Countries parameter: optional
• Context key to check: optional (otherwise the meta.headers.callerNumber key will be checked)