Summa icon

Summa

Consume Summa API (v.0.1.7)
Join our community

Actions182

Overview

This node integrates with the Summa API to create a Call Forward Supplementary Service for an SS Subscription via SOAP. It allows users to configure call forwarding settings such as activation state, forwarding address, timers, and notification preferences on a subscriber's supplementary service subscription.

Typical use cases include telecom operators or service providers who want to automate the management of call forwarding features on subscribers' accounts. For example, enabling unconditional call forwarding to a specific number when the subscriber is unreachable or busy.

Properties

Name Meaning
Activation State The activation status of the call forwarding service. Options: NOT_ACTIVE, ACTIVE_AND_OPERATIVE.
Address The destination address (phone number or URI) to which calls will be forwarded.
Address Nature The nature/type of the address. Options include: UNKNOWN, INTERNATIONAL_NUMBER, NATIONAL_SIGNIFICANT_NUMBER, NETWORK_SPECIFIC_NUMBER, SUBSCRIBER_NUMBER, RESERVED, ABBREVIATED_NUMBER, RESERVED_FOR_EXTENSIO.
Address Type The format/type of the address. Options include various telephony and network address types such as ADDRESS_E164 (default), ADDRESS_IP, ADDRESS_IPV6, ADDRESS_DNS, etc.
Numbering Plan The numbering plan used for the address. Options: UNKNOWN, ISDN, DATA, TELEX, LAND_MOBILE, NATIONAL, PRIVATE_PLAN, RESERVED, among others.
Id Identifier for the specific call forwarding supplementary service instance.
Induction State Indicates whether the service is induced or not. Options: NOT_INDUCED, INDUCED.
No Reply Condition Timer Timer value specifying how long to wait before forwarding the call if there is no reply.
Notify To Cg Party Boolean flag indicating whether to notify the call generating party about the forwarding.
Notify To Fwding Party Boolean flag indicating whether to notify the forwarding party.
Present Msisdn Boolean flag indicating whether to present the MSISDN (subscriber number) in the forwarded call.
Provisioning State Provisioning status of the service. Options: NOT_PROVISIONED, PROVISIONED.
Registration State Registration status of the service. Options: REGISTERED, NOT_REGISTERED, ERASED, NOT_APPLICABLE.
Supplementary Service Type The type of supplementary service being created. Default is CallForwardUnconditional.
SS Subscription ID Identifier of the SS Subscription to which this call forwarding service belongs.
Operator ID Identifier of the operator managing the subscription/service.

Output

The node outputs JSON data representing the result of the creation operation for the call forward supplementary service. This typically includes confirmation details, status codes, or any returned metadata from the Summa API related to the newly created service.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Summa API.
  • The node uses an HTTP client internally to communicate with the Summa backend services.
  • Proper configuration of the Summa API credentials within n8n is necessary.
  • The node depends on the Summa API version specified in the bundled source (v.${F.version}).

Troubleshooting

  • Authentication errors: Ensure that the API key credential is correctly configured and valid.
  • Invalid input values: Required fields like Address, Id, SS Subscription ID, and Operator ID must be provided and correctly formatted.
  • Unsupported address or numbering plan: Verify that the selected options for Address Nature, Address Type, and Numbering Plan are compatible with the Summa API expectations.
  • Timeouts or connectivity issues: Check network connectivity and API endpoint availability.
  • Error responses from API: Review the error message returned by the API for clues; common issues include invalid parameters or insufficient permissions.

Links and References

Discussion