왜요?

즉시 결제로 작업할 때 모든 것이 즉시 이루어지기를 원합니다. 그래서 OpenPix 계정에 들어오는 모든 새 거래에 대한 알림도 실시간으로 받고 싶습니다. 이를 가능하게 하기 위해 저는 OpenPix Webhook 페이로드를 수신하고 이를 Incoming Webhook 형식으로 변환하여 Slack으로 보내는 작은 람다를 만들었습니다. 이를 구현하려면 50줄 미만의 코드가 필요합니다. 보여드리겠습니다.

오픈픽스

OpenPix는 회사가 Pix를 사용하여 거래를 받을 수 있도록 하는 브라질의 즉시 결제 스타트업입니다. 매우 효과적인 즉시 지불 방법.
당신이 그것에 대해 더 알고 싶다면 여기 그들의 웹 사이트입니다.

웹후크

솔루션으로 이동하기 전에 Webhook이 무엇인지 이해합시다. 첫 번째는 이벤트가 발생하는 즉시 한 프로그램에서 다른 프로그램으로 데이터를 보낼 수 있도록 하는 서비스입니다. 요청을 해야 하는 API의 반대이며 웹후크가 데이터를 보냅니다. 통합을 위해 Slack의 기능인 OpenPix 및 Incoming Webhook의 웹후크를 사용합니다.
수신 웹후크는 외부 소스가 해당 콘텐츠를 애플리케이션(이 경우에는 Slack)과 공유할 수 있도록 합니다. OpenPix가 이미 다음과 같은 webhook 페이로드를 제공하기 때문에 필요한 것입니다.

{  
    "pixQrCode": null,  
    "charge": null,  
    "pix": {    
        "pixQrCode": null,    
        "charge": null,    
        "time": "2021-03-12T12:44:09.269Z",    
        "value": 1,    
        "transactionID": "ea83401ed4834b3ea6f1f283b389af29",   
        "infoPagador": "OpenPix testing",    
        "customer": {      
            "correlationID": "9134e286-6f71-427a-bf00-241681624586", 
            "email": "[email protected]",      
            "name": "Loma",      
            "phone": "+5511999999999",      
            "taxID": {        
                "taxID": "47043622050",        
                "type": "BR:CPF"      
            }    
        },    
        "payer": {      
            "correlationID": "9134e286-6f71-427a-bf00-241681624586",
            "email": "[email protected]",      
            "name": "Loma",      
            "phone": "+5511999999999",      
            "taxID": {        
                "taxID": "47043622050",        
                "type": "BR:CPF"      
            }    
        }  
    },  
    "company": {    
        "id": "624f46f9e93f9f521c8308d7",    
        "name": "Pizzaria do José",    
        "taxID": "4722767300014"  },  
        "account": {    
            "clientId": "ZOJ64B9B-ZM1W-89MI-4UCI-OP2LVIU6NY75"  
        }
    }

어떻게

시작하려면 Slack 작업 공간에 새 앱을 만들고 수신 웹후크를 수신하도록 허용해야 합니다. 방법은 여기에서 확인하세요: Creating an App

그런 다음 람다 함수를 생성하면 이 함수는 OpenPix에서 페이로드를 수신하고 Slack으로 전송하도록 형식을 지정합니다. 람다 없이도 할 수 있지만 저는 확장을 위해 사용했습니다(트랜잭션을 많이 받는 경우에도 사용을 고려하십시오). Lambda는 API에 요청을 전송하는 것만으로 함수를 트리거할 수 있기 때문에 API 게이트웨이와 쉽게 통합됩니다. 말씀드린 대로 함수는 OpenPix에서 페이로드를 변환하여 작업 공간으로 보내므로 위의 페이로드를 예로 들 수 있습니다.
OpenPix에서 새 웹후크를 만드는 것은 쉽습니다. API/플러그인을 누른 다음 새 웹후크를 누르면 이 페이지가 표시됩니다.



여기에 API 게이트웨이 URL을 입력하고 웹후크를 트리거할 시기를 선택합니다. 그것이 플랫폼에서 해야 할 전부입니다.

다음은 기본 구현을 사용하여 Slack에서 알림이 어떻게 보이는지에 대한 예입니다. 문서here를 따르면 원하는 대로 쉽게 만들 수 있습니다.



축하합니다. 방금 OpenPix를 Slack과 통합했습니다. 내 repo에서 구현하는 방법에 대한 추가 지침은 내가 만든 코드를 확인할 수 있습니다. 필요하시면 언제든지 에 연락하십시오.