diff --git a/notifier.rst b/notifier.rst
index 47688a6b1da..29af133278a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -55,9 +55,9 @@ to send SMS messages to mobile phones. This feature requires subscribing to
a third-party service that sends SMS messages. Symfony provides integration
with a couple popular SMS services:
-================== ===================================== ===========================================================================
-Service Package DSN
-================== ===================================== ===========================================================================
+================== ===================================== ========================================================================================================================= ===============
+Service Package DSN Webhook support
+================== ===================================== ========================================================================================================================= ===============
`46elks`_ ``symfony/forty-six-elks-notifier`` ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
`AllMySms`_ ``symfony/all-my-sms-notifier`` ``allmysms://LOGIN:APIKEY@default?from=FROM``
`AmazonSns`_ ``symfony/amazon-sns-notifier`` ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
@@ -95,10 +95,10 @@ Service Package DSN
`SpotHit`_ ``symfony/spot-hit-notifier`` ``spothit://TOKEN@default?from=FROM``
`Telnyx`_ ``symfony/telnyx-notifier`` ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
`TurboSms`_ ``symfony/turbo-sms-notifier`` ``turbosms://AUTH_TOKEN@default?from=FROM``
-`Twilio`_ ``symfony/twilio-notifier`` ``twilio://SID:TOKEN@default?from=FROM``
+`Twilio`_ ``symfony/twilio-notifier`` ``twilio://SID:TOKEN@default?from=FROM`` yes
`Vonage`_ ``symfony/vonage-notifier`` ``vonage://KEY:SECRET@default?from=FROM``
`Yunpian`_ ``symfony/yunpian-notifier`` ``yunpian://APIKEY@default``
-================== ===================================== ===========================================================================
+================== ===================================== ========================================================================================================================= ===============
.. versionadded:: 6.1
@@ -116,6 +116,12 @@ Service Package DSN
were introduced in Symfony 6.3.
The ``from`` option in ``Smsapi`` DSN is optional since Symfony 6.3.
+.. tip::
+
+ Some third party transports, when using the API, support status callback
+ via webhooks. See the :doc:`Webhook documentation ` for more
+ details.
+
To enable a texter, add the correct DSN in your ``.env`` file and
configure the ``texter_transports``:
diff --git a/webhook.rst b/webhook.rst
index d79e1479e08..b7457bb2e08 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -106,7 +106,7 @@ With this done, you can now add a RemoteEvent consumer to react to the webhooks:
use Symfony\Component\RemoteEvent\RemoteEvent;
#[AsRemoteEventConsumer('mailer_mailgun')]
- final readonly class WebhookListener implements ConsumerInterface
+ class WebhookListener implements ConsumerInterface
{
public function consume(RemoteEvent $event): void
{
@@ -130,3 +130,48 @@ With this done, you can now add a RemoteEvent consumer to react to the webhooks:
// Handle the mail engagement event
}
}
+
+Usage in combination with the Notifier component
+------------------------------------------------
+
+The usage of the Webhook component when using a third-party transport in
+the Notifier is very similar to the usage with the Mailer.
+
+Currently, the following third-party sms transports support webhooks:
+
+============ ==========================================
+SMS service Parser service name
+============ ==========================================
+Twilio ``notifier.webhook.request_parser.twilio``
+============ ==========================================
+
+.. versionadded:: 6.3
+
+ The support for Twilio was introduced in Symfony 6.3.
+
+For SMS transports, an additional ``SmsEvent`` is available in the RemoteEvent
+consumer::
+
+ use Symfony\Component\RemoteEvent\Attribute\AsRemoteEventConsumer;
+ use Symfony\Component\RemoteEvent\Consumer\ConsumerInterface;
+ use Symfony\Component\RemoteEvent\Event\Sms\SmsEvent;
+ use Symfony\Component\RemoteEvent\RemoteEvent;
+
+ #[AsRemoteEventConsumer('notifier_twilio')]
+ class WebhookListener implements ConsumerInterface
+ {
+ public function consume(RemoteEvent $event): void
+ {
+ if ($event instanceof SmsEvent) {
+ $this->handleSmsEvent($event);
+ } else {
+ // This is not an sms event
+ return;
+ }
+ }
+
+ private function handleSmsEvent(SmsEvent $event): void
+ {
+ // Handle the sms event
+ }
+ }
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy