Setting Up Webhooks

📘

Special permission is required to enable the mentioned webhook services. Please reach out to [email protected] for more information.

After your webhooks services enablement, please follow the steps below to complete your subscription to the HTTPS events:

1. Upon approval (By Telna Business Operational Team), Telna will send a subscription confirmation message to your pre-determined endpoint via HTTPS (from AWS SNS). The message will contain details like the method, headers, and body. Here is a sample request:.

POST / HTTP/1.1  
x-amz-sns-message-type: SubscriptionConfirmation  
x-amz-sns-message-id: 165545c9-2a5c-472c-8df2-7ff2be2b3b1b  
x-amz-sns-topic-arn: arn:aws:sns:us-west-2:123456789012:MyTopic  
Content-Length: 1336  
Content-Type: text/plain; charset=UTF-8  
Host: example.com  
Connection: Keep-Alive  
User-Agent: Amazon Simple Notification Service Agent

{  
  "Type" : "SubscriptionConfirmation",  
  "MessageId" : "165545c9-2a5c-472c-8df2-7ff2be2b3b1b",  
  "Token" : "2336412f37f...",  
  "TopicArn" : "arn:aws:sns:us-west-2:123456789012:MyTopic",  
  "Message" : "You have chosen to subscribe to the topic arn:aws:sns:us-west-2:123456789012:MyTopic.\\nTo confirm the subscription, visit the SubscribeURL included in this message.",  
  "SubscribeURL" : "<https://sns.us-west-2.amazonaws.com/?Action=ConfirmSubscription&TopicArn=arn:aws:sns:us-west-2:123456789012:MyTopic&Token=2336412f37...">,  
  "Timestamp" : "2012-04-26T20:45:04.751Z",  
  "SignatureVersion" : "1",  
  "Signature" : "EXAMPLEpH+...",  
  "SigningCertURL" : "<https://sns.us-west-2.amazonaws.com/SimpleNotificationService-f3ecfb7224c7233fe7bb5f59f96de52f.pem">  
}

2. The application/code at the endpoint must retrieve theSubscribeURLvalue from the subscription confirmation message and either visit the location specified bySubscribeURLitself or make it available to you so that you can manually visit the link specified in theSubscribeURLfield, for example, using a web browser.
3. Please note that the payload and format of the subscription request differ from the payload and format of the subscribed webhook. Please refer to the webhook reference in the documentation for the actual webhook specifications. The Webhook Reference will provide the correct payload structure and format to correctly set up and handle webhook events.
4. Once the URL location is visited, the webhook subscription is completed, and the events should start flowing to the endpoint within a few hours.

For more detailed information and specifications on handling webhook events, please consult the Webhook Reference. If you encounter any issues or have questions during the webhook implementation process, please contact our support team for assistance.