View a markdown version of this page

Notificações de erro quando uma regra do Connect Customer falha na execução - Amazon Connect Customer

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Notificações de erro quando uma regra do Connect Customer falha na execução

É 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 o Connect Customer Rules 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 Connect Customer envia notificações de erro usando EventBridge eventos da Amazon.

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

Inscrever-se para EventBridge receber notificações

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 regras do Contact Lens”

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 saber mais sobre o ASSIGN_CONTACT_CATEGORY, consulte Notificações de erro: quando o Contact Lens não consegue 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 Connect Customer.

  • 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.