SQL Server Requires Chilkat v11.0.0+
SQL Server
SendGrid: Schedule a reminder and cancel it by batch ID
See more SendGrid Examples
Schedule a reminder one hour from now. Save its batch ID when it is allocated. If the appointment is canceled, use that saved ID in the cancellation branch. Mail Send accepts a Unix timestamp up to 72 hours ahead; cancel at least 10 minutes before the send time. Cancellation applies to the entire batch.
Create a batch ID ยท Cancel a batch
Chilkat SQL Server Downloads
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
DECLARE @hr int
DECLARE @iTmp0 int
DECLARE @sTmp0 nvarchar(4000)
DECLARE @success int
SELECT @success = 0
-- Assumes Chilkat is unlocked. See Global Unlock Sample.
SELECT @success = 0
DECLARE @http int
EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
IF @hr <> 0
BEGIN
PRINT 'Failed to create ActiveX component'
RETURN
END
EXEC sp_OASetProperty @http, 'RequireSslCertVerify', 1
-- Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
EXEC sp_OASetProperty @http, 'AuthToken', 'SENDGRID_API_KEY'
DECLARE @resp int
EXEC @hr = sp_OACreate 'Chilkat.HttpResponse', @resp OUT
-- On cancellation, set this to the batch ID saved with the original appointment.
-- This branch does not create a new batch or send another reminder.
DECLARE @batchToCancel nvarchar(4000)
SELECT @batchToCancel = ''
IF @batchToCancel <> ''
BEGIN
DECLARE @cancellation int
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @cancellation OUT
EXEC sp_OAMethod @cancellation, 'UpdateString', @success OUT, 'batch_id', @batchToCancel
EXEC sp_OAMethod @cancellation, 'UpdateString', @success OUT, 'status', 'cancel'
EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'POST', 'https://api.sendgrid.com/v3/user/scheduled_sends', @cancellation, 'application/json', @resp
IF @success <> 1
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
IF @iTmp0 = 0
BEGIN
EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
PRINT @sTmp0
END
ELSE
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
RETURN
END
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
IF @iTmp0 <> 201
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
RETURN
END
PRINT 'Batch cancellation accepted.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
RETURN
END
EXEC sp_OAMethod @http, 'HttpNoBody', @success OUT, 'POST', 'https://api.sendgrid.com/v3/mail/batch', @resp
IF @success <> 1
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
IF @iTmp0 = 0
BEGIN
EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
PRINT @sTmp0
END
ELSE
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
RETURN
END
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
IF @iTmp0 <> 201
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
RETURN
END
DECLARE @batch int
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @batch OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
EXEC sp_OAMethod @batch, 'Load', @success OUT, @sTmp0
IF @success <> 1
BEGIN
PRINT 'Unexpected response: expected JSON.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
EXEC @hr = sp_OADestroy @batch
RETURN
END
DECLARE @batchId nvarchar(4000)
EXEC sp_OAMethod @batch, 'StringOf', @batchId OUT, 'batch_id'
EXEC sp_OAMethod @batch, 'HasMember', @iTmp0 OUT, 'batch_id'
IF @iTmp0 <> 1
BEGIN
PRINT 'Missing batch_id in response.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
EXEC @hr = sp_OADestroy @batch
RETURN
END
-- Allocate one batch per independently cancelable appointment.
PRINT 'Save this batch ID with the appointment: ' + @batchId
DECLARE @sendTime int
EXEC @hr = sp_OACreate 'Chilkat.CkDateTime', @sendTime OUT
EXEC sp_OAMethod @sendTime, 'SetFromCurrentSystemTime', @success OUT
EXEC sp_OAMethod @sendTime, 'AddSeconds', @success OUT, 3600
DECLARE @message int
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @message OUT
EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'batch_id', @batchId
EXEC sp_OAMethod @sendTime, 'GetAsUnixTime', @iTmp0 OUT, 0
EXEC sp_OAMethod @message, 'UpdateInt', @success OUT, 'send_at', @iTmp0
EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'from.email', 'sender@example.com'
EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'personalizations[0].to[0].email', 'recipient@example.com'
EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'subject', 'Appointment reminder'
EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'content[0].type', 'text/plain'
EXEC sp_OAMethod @message, 'UpdateString', @success OUT, 'content[0].value', 'Your appointment is tomorrow at 9:30 AM Central.'
EXEC sp_OAMethod @http, 'HttpJson', @success OUT, 'POST', 'https://api.sendgrid.com/v3/mail/send', @message, 'application/json', @resp
IF @success <> 1
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
IF @iTmp0 = 0
BEGIN
EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
PRINT @sTmp0
END
ELSE
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
EXEC @hr = sp_OADestroy @batch
EXEC @hr = sp_OADestroy @sendTime
EXEC @hr = sp_OADestroy @message
RETURN
END
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
IF @iTmp0 <> 202
BEGIN
EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
PRINT 'HTTP ' + @iTmp0 + ': ' + @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
EXEC @hr = sp_OADestroy @batch
EXEC @hr = sp_OADestroy @sendTime
EXEC @hr = sp_OADestroy @message
RETURN
END
EXEC sp_OAMethod @sendTime, 'GetAsTimestamp', @sTmp0 OUT, 0
PRINT 'Reminder scheduled for ' + @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @resp
EXEC @hr = sp_OADestroy @cancellation
EXEC @hr = sp_OADestroy @batch
EXEC @hr = sp_OADestroy @sendTime
EXEC @hr = sp_OADestroy @message
END
GO