Summa icon

Summa

Consume Summa API (v.0.1.7)

Actions182

Overview

This node integrates with the Summa API to manage various telecommunication subscription services. Specifically, for the SS Subscription resource and the Add Call Forwarding Custom Supplementary Service operation, it allows users to add a custom call forwarding service to a subscriber's profile.

Typical use cases include telecom operators or service providers who want to programmatically configure call forwarding settings on subscribers' accounts, such as forwarding calls to another number under specific conditions.

For example, a user can specify a subscriber by their IMSI (International Mobile Subscriber Identity), define the forwarding number (FTN), select the type of call forwarding service, and decide whether the calling party should be notified when the call is forwarded.

Properties

Name Meaning
Imsi The International Mobile Subscriber Identity identifying the subscriber to modify.
Ftn The forwarding telephone number where calls will be redirected.
Call Forward Service Type The type of call forwarding service to apply (e.g., unconditional, busy, no reply).
Notify To Calling Party Boolean flag indicating if the calling party should be notified about the call forwarding.

Output

The node outputs JSON data representing the result of the API call to add the call forwarding supplementary service. This typically includes confirmation details such as success status, any identifiers related to the created service, or error messages if the operation failed.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Summa API via an API key credential.
  • The node depends on the summaApi credential configured in n8n for authentication.
  • Internally uses HTTP client utilities and operation resolvers to communicate with the Summa backend.

Troubleshooting

  • Common Issues:

    • Invalid or missing IMSI or FTN values may cause the API to reject the request.
    • Incorrect call forward service type values not supported by the API.
    • Authentication failures due to invalid or expired API credentials.
    • Network connectivity issues preventing communication with the Summa API.
  • Error Messages:

    • Errors returned from the API will typically indicate invalid parameters or authorization problems.
    • If the "Notify To Calling Party" flag is set incorrectly, the API might return validation errors.
  • Resolutions:

    • Verify all required fields are correctly filled and formatted.
    • Ensure the API key credential is valid and has necessary permissions.
    • Check network access and endpoint availability.
    • Consult API documentation for valid call forward service types.

Links and References

Discussion