Notificações de erro quando a regra do Amazon Connect não é executada

É importante saber quando houve falha em uma ação de regra específica em um ambiente de produção e o que causou a falha. Dessa maneira, é possível mitigar proativamente essas falhas no futuro.

Para obter informações em tempo real sobre as ações que não foram executadas, você integra as regras do Amazon Connect aos EventBridge eventos da Amazon. Isso permite que você receba notificação quando, por exemplo, houver falha na ação “Criar tarefa” porque o número máximo de Tarefas ativas simultâneas por instância atingiu a cota de serviço. Quando isso acontece, o Amazon Connect envia notificações de erro usando EventBridge eventos da Amazon.

Os eventos são emitidos com base no melhor esforço.

Assinar notificações do EventBridge

Para assinar essas notificações, crie uma EventBridge regra personalizada que corresponda ao seguinte:

• "source" = "aws.connect"

• “detail-type” = "Falha na execução da ação de Contact Lens regras”

Também é possível adicionar ao padrão para receber notificação quando ocorrer um código de evento específico. Para obter mais informações, consulte Padrões de eventos no Guia EventBridge do usuário da Amazon.

O formato de uma notificação é semelhante ao seguinte exemplo:

{
  "version": "0",
  "id": "8d122163-6c07-f8cb-06e7-373a1bcf8fc6",
  "source": "aws.connect",
  "detail-type": "Amazon Connect Rules Action Execution Failed",
  "account": "123456789012",
  "time": "2022-01-05T01:30:42Z",
  "region": "us-east-1",
  "resources": ["arn:aws:connect:us-east-1:123456789012:instance/cb54730f-5aac-4376-b2f4-7c822889931e"],
  "detail": {
    "ruleId": "7410c94b-21c2-4db0-a707-c6d751edbe8f",
    "actionType": "CREATE_TASK",
    "triggerEvent": "THIRD_PARTY",
    "instanceArn": "arn:aws:connect:us-east-1:123456789012:instance/cb54730f-5aac-4376-b2f4-7c822889931e",
    "reasonCode": "ResourceNotFoundException",
    "error": "ContactFlowId provided does not belong to connect instance",
    "additionalInfo": "{\n  \"message\": \"Not Found\",\n  \"code\": \"ResourceNotFoundException\",\n  \"statusCode\": 404,\n  \"time\": \"2022-01-03T20:23:07.073Z\",\n  \"requestId\": \"048e4403-71c1-47d6-96fc-825744f518e7\",\n  \"retryable\": false,\n  \"retryDelay\": 28.217537834500316\n}"
  }
}

Tipos de ação compatíveis

• CREATE_TASK

• GENERATE_EVENTBRIDGE_EVENT

• SEND_NOTIFICATION

Para obter mais informações sobre o ASSIGN_CONTACT_CATEGORY, consulte Notificações de erro: quando não Contact Lens consigo analisar um contato.

Eventos de gatilho compatíveis

• REAL_TIME_CALL

• REAL_TIME_CHAT

• POST_CALL

• POST_CHAT

• THIRD_PARTY

Códigos de motivo de falha nas ações

Quando há falha em uma ação, o serviço de notificação de erros coleta os códigos de motivo das ações compatíveis. Para obter mais informações sobre os códigos de motivo das falhas de tarefas e EventBridge ações, consulte os tópicos a seguir:

• Para obter códigos de motivo para falhas na ação da tarefa, consulte o tópico Erros na StartTaskContactAPI no Guia de referência da API Amazon Connect.

• Para obter códigos de motivo para falhas de EventBridge ação, consulte o tópico Erros na PutEventsAPI no Guia de referência de EventBridge API da Amazon.